SELECT ステートメント

SELECT ステートメントは次の基本的な句で構成できます。

SELECT
INTO
FROM
JOIN
WHERE
GROUP BY
HAVING
UNION
ORDER BY
LIMIT

SELECT 構文

次の構文ダイアグラムは、本製品のSQL エンジンでサポートされている構文の概要を示します。

SELECT {
  [ TOP <numeric_literal> | DISTINCT ]
  { 
    * 
    | { 
        <expression> [ [ AS ] <column_reference> ] 
        | { <table_name> | <correlation_name> } .* 
      } [ , ... ] 
  }
  { 
    FROM <table_reference> [ [ AS ] <identifier> ] 
  } [ , ... ]
  [ [  
      INNER | { { LEFT | RIGHT | FULL } [ OUTER ] } 
    ] JOIN <table_reference> [ ON <search_condition> ] [ [ AS ] <identifier> ] 
  ] [ ... ] 
  [ WHERE <search_condition> ]
  [ GROUP BY <column_reference> [ , ... ]
  [ HAVING <search_condition> ]
  [ UNION [ ALL ] <select_statement> ]
  [ 
    ORDER BY 
    <column_reference> [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ]
  ]
  [ 
    LIMIT <expression>
    [ 
      { OFFSET | , }
      <expression> 
    ]
  ] 
} | SCOPE_IDENTITY() 

<expression> ::=
  | <column_reference>
  | @ <parameter> 
  | ?
  | COUNT( * | { [ DISTINCT ] <expression> } )
  | { AVG | MAX | MIN | SUM | COUNT } ( <expression> ) 
  | NULLIF ( <expression> , <expression> ) 
  | COALESCE ( <expression> , ... ) 
  | CASE <expression>
      WHEN { <expression> | <search_condition> } THEN { <expression> | NULL } [ ... ]
    [ ELSE { <expression> | NULL } ]
    END 
  | {RANK() | DENSE_RANK()} OVER ([PARTITION BY <column_reference>] {ORDER BY <column_reference>})
  | <literal>
  | <sql_function> 

<search_condition> ::= 
  {
    <expression> { = | > | < | >= | <= | <> | != | LIKE | NOT LIKE | IN | NOT IN | IS NULL | IS NOT NULL | AND | OR | CONTAINS | BETWEEN } [ <expression> ]
  } [ { AND | OR } ... ]

サンプル

すべてのカラムを返す：
```
SELECT * FROM WorkItems
```

カラムをリネームする：

SELECT [BuildNumber] AS MY_BuildNumber FROM WorkItems

カラムのデータを別のデータ型としてキャストする：

SELECT CAST(AnnualRevenue AS VARCHAR) AS Str_AnnualRevenue FROM WorkItems

データを検索する：

SELECT * FROM WorkItems WHERE Reason = 'Manual'

クエリ条件に一致するアイテムの数を返す：
```
SELECT COUNT(*) AS MyCount FROM WorkItems 
```
クエリ条件に一致する一意のアイテムの数を返す：
```
SELECT COUNT(DISTINCT BuildNumber) FROM WorkItems 
```
クエリ条件に一致する一意のアイテムを返す：
```
SELECT DISTINCT BuildNumber FROM WorkItems 
```

昇順で結果をソートする：

SELECT Id, BuildNumber FROM WorkItems  ORDER BY BuildNumber ASC

指定した行数に結果を制限する：

SELECT Id, BuildNumber FROM WorkItems LIMIT 10

実行時にインプットに渡すためクエリをパラメータ化する。これにより、prepared statement を作成しSQL インジェクション攻撃を鎮めることができます：
```
SELECT * FROM WorkItems WHERE Reason = @param
```

オフラインモードでSELECT ステートメントを使う方法については、明示的なデータのキャッシュを参照してください。

疑似カラム

SELECT ステートメントで入力専用フィールドを使用できます。これらのフィールド（疑似カラム）は、結果には通常のカラムとして表示されることはありませんが、WHERE 句の一部として指定できます。疑似カラムを使用して、Azure DevOps から追加機能にアクセスできます。

    SELECT * FROM WorkItems WHERE Pseudo = '@Pseudo'

集計関数

集計関数を使用したSELECT の例については集計関数を参照してください。

JOIN クエリ

JOIN を使用したSELECT クエリの例についてはJOIN クエリを参照してください。

日付リテラル関数

日付リテラル関数には、日付リテラル関数を使用したSELECT 例が含まれています。

Window 関数

Window 関数を含むSELECT 例については、Window 関数を参照してください。

テーブル値関数

テーブル値関数を使用したSELECT 例については、テーブル値関数を参照してください。

CData Python Connector for Azure DevOps