SELECT コマンド - Amazon Simple Storage Service
SELECT のリスト FROM 句WHERE 句LIMIT 句属性アクセスヘッダーおよび属性名の大文字と小文字の区別ユーザー定義の用語としての予約キーワードの使用スカラー式

SELECT コマンド

Amazon S3 セレクトは、SELECT SQL コマンドのみをサポートします。次の ANSI スタンダードの句は、SELECT 用にサポートされています。

  • SELECT リスト

  • FROM 句

  • WHERE 句

  • LIMIT 句

注記

Amazon S3 Select クエリは、現在サブクエリや結合はサポートしていません。

SELECT のリスト

SELECT リストは、クエリに返させる列、関数、および式を指定します。このリストは、クエリの出力を表しています。

SELECT *
SELECT projection1 AS column_alias_1, projection2 AS column_alias_2

SELECT (アスタリスク) を使用した最初の SELECT 形式では、WHERE 句を通過したすべての行がそのまま返されます。2 番目の SELECT 形式では、列ごとにユーザー定義の出力スカラー式 projection1 および projection2 を含む行が作成されます。

FROM 句

Amazon S3 Select では、FROM 句の以下の形式がサポートされています。

FROM table_name
FROM table_name alias
FROM table_name AS alias

FROM 句の各形式で、table_name はクエリの対象となる S3Object です。従来のリレーショナルデータベースから移行したユーザーは、これをテーブルに対する複数のビューを含むデータベーススキーマとして考えることができます。

スタンダード SQL に従って、FROM 句は WHERE 句でフィルタリングされ SELECT リストで射影される行を作成します。

Amazon S3 Select に格納されている JSON オブジェクトでは、次の形式の FROM 句も使用することができます。

FROM S3Object[*].path
FROM S3Object[*].path alias
FROM S3Object[*].path AS alias

この形式の FROM 句を使用すると、JSON オブジェクト内の配列またはオブジェクトから選択できます。以下のいずれかの形式で path を指定できます。

  • 名前 (オブジェクト内): .name または ['name']

  • インデックス (配列内): [index]

  • ワイルドカード文字 (オブジェクト内): .*

  • ワイルドカード文字 (配列内): [*]

注記

  • この形式の FROM 句は JSON オブジェクトに対してのみ機能します。

  • ワイルドカード文字は常に最低 1 つのレコードを発行します。レコードが一致しない場合、Amazon S3 Select は値 MISSING を発行します。出力のシリアル化中 (クエリの実行の完了後)、Amazon S3 Select は MISSING 値を空のレコードに置き換えます。

  • 集約関数 (AVG、COUNT、MAX、MIN、および SUM) は、MISSING 値をスキップします。

  • エイリアスを指定せずにワイルドカード文字を使用する場合は、パスの最後の要素を使用して行を参照できます。例えば、クエリ SELECT price FROM S3Object[*].books[*].price を使用して、ブックのリストからすべての価格を選択できます。パスが名前ではなくワイルドカード文字で終わる場合は、値 _1 を使用して行を参照できます。例えば、SELECT price FROM S3Object[*].books[*].price の代わりにクエリ SELECT _1.price FROM S3Object[*].books[*] を使用できます。

  • Amazon S3 Select は常に JSON ドキュメントをルートレベルの値の配列として扱います。したがって、クエリ対象の JSON オブジェクトにルート要素が 1 つしかない場合でも、FROM 句は S3Object[*] で始める必要があります。ただし、互換性の理由から、パスを含めない場合、Amazon S3 Select ではワイルドカード文字を省略できます。そのため、完全な句 FROM S3Object は、FROM S3Object[*] as S3Object と同等です。パスを含める場合は、ワイルドカード文字も使用する必要があります。つまり、FROM S3Object と FROM S3Object[*].path はどちらも有効な句ですが、FROM S3Object.path は有効な句ではありません。

例:

例 1:

この例では、以下のデータセットとクエリを使用した場合の結果を示しています。

{ "Rules": [ {"id": "1"}, {"expr": "y > x"}, {"id": "2", "expr": "z = DEBUG"} ]}
{ "created": "June 27", "modified": "July 6" }
SELECT id FROM S3Object[*].Rules[*].id
{"id":"1"}
{}
{"id":"2"}
{}

Amazon S3 Select は、以下の理由で次の結果を生成します。

  • {"id":"id-1"} — S3Object[0].Rules[0].id は一致を生成しました.

  • {} — S3Object[0].Rules[1].id はレコードと一致しなかったため、Amazon S3 Select が MISSING を出力しました。これは、出力のシリアル化中に空のレコードに変更されて返されます。

  • {"id":"id-2"} — S3Object[0].Rules[2].id は一致を生成しました。

  • {} — S3Object[1] は Rules で一致しなかったため、Amazon S3 Select が MISSING を出力しました。これは、出力のシリアル化中に空のレコードに変更されて返されます。

一致が見つからないときに Amazon S3 Select が空のレコードを返さないようにするには、MISSING という値をテストします。次のクエリは前のクエリと同じ結果を返しますが、空の値は省略されています。

SELECT id FROM S3Object[*].Rules[*].id WHERE id IS NOT MISSING
{"id":"1"}
{"id":"2"}

例 2:

この例は、以下のデータセットとクエリを使用した場合の結果を示しています。

{ "created": "936864000", "dir_name": "important_docs", "files": [ { "name": "." }, { "name": ".." }, { "name": ".aws" }, { "name": "downloads" } ], "owner": "Amazon S3" }
{ "created": "936864000", "dir_name": "other_docs", "files": [ { "name": "." }, { "name": ".." }, { "name": "my stuff" }, { "name": "backup" } ], "owner": "User" }
SELECT d.dir_name, d.files FROM S3Object[*] d
{"dir_name":"important_docs","files":[{"name":"."},{"name":".."},{"name":".aws"},{"name":"downloads"}]}
{"dir_name":"other_docs","files":[{"name":"."},{"name":".."},{"name":"my stuff"},{"name":"backup"}]}
SELECT _1.dir_name, _1.owner FROM S3Object[*]
{"dir_name":"important_docs","owner":"Amazon S3"}
{"dir_name":"other_docs","owner":"User"}

WHERE 句

WHERE 句は、この構文に従います。

WHERE condition

WHERE 句は condition に基づいて行をフィルタリングします。condition は、ブール型の結果を持つ式です。condition の結果が TRUE である行のみが結果で返されます。

LIMIT 句

LIMIT 句は、この構文に従います。

LIMIT number

LIMIT 句により、number に基づいてクエリで返されるレコードの数を制限できます。

属性アクセス

SELECT 句および WHERE 句は、クエリ対象のファイルが CSV 形式であるか JSON 形式にあるかによって、以下のセクションのいずれかのメソッドを使用してレコードデータを参照できます。

CSV

  • 列番号 – 行の N 番目の列を参照できます。_N は列名、N は列位置です。位置カウントは 1 から始まります。たとえば、最初の列名は _1 で、2 番目の列名は _2 です。

    列は _N または alias._N として参照できます。たとえば、_2 と myAlias._2 はどちらも SELECT リストおよび WHERE 句の列を参照するのに有効な方法です。

  • 列ヘッダー – ヘッダー行を持つ CSV 形式のオブジェクトの場合、ヘッダーは SELECT リストおよび WHERE 句で利用できます。特に、従来の SQL では、SELECT および WHERE 句の式内で、alias.column_name または column_name で列を参照できます。

JSON

  • ドキュメント – JSON ドキュメントのフィールドは alias.name としてアクセスできます。ネストされたフィールド (alias.name1.name2.name3 など) にもアクセスできます。

  • リスト – [] 演算子でゼロベースのインデックスを使用して、JSON リストの要素にアクセスできます。例えば、リストの 2 番目の要素に alias[1] としてアクセスできます。アクセスするリスト要素とフィールドを組み合わせることができます (例: alias.name1.name2[1].name3)。

  • 例: この JSON オブジェクトをサンプルデータセットとして考えます。

    {"name": "Susan Smith",
"org": "engineering",
"projects":
    [
     {"project_name":"project1", "completed":false},
     {"project_name":"project2", "completed":true}
    ]
}

    例 1:

    以下のクエリは次の結果を返します。

    Select s.name from S3Object s
    {"name":"Susan Smith"}

    例 2:

    以下のクエリは次の結果を返します。

    Select s.projects[0].project_name from S3Object s
    {"project_name":"project1"}

ヘッダーおよび属性名の大文字と小文字の区別

Amazon S3 Select では、二重引用符を使用して、列ヘッダー (CSV オブジェクトの場合) および属性 (JSON オブジェクトの場合) の大文字と小文字を区別することを指定できます。二重引用符がない場合、オブジェクトヘッダーおよび属性の大文字と小文字は区別されません。あいまいな場合はエラーがスローされます。

以下の例は、1) 指定された列ヘッダーを持ち、クエリリクエストに対して FileHeaderInfo が "Use" に設定されている CSV 形式 の Amazon S3 オブジェクト、または 2) 指定された属性を持つ JSON 形式の Amazon S3 オブジェクトのいずれかです。

例 #1: クエリ対象のオブジェクトには NAME というヘッダーまたは属性があります。

  • 次の式は、オブジェクトから値を正常に返します。引用符がないため、クエリの大文字と小文字は区別されません。

    SELECT s.name from S3Object s

  • 次の式は 400 エラー MissingHeaderName を返します。引用符があるため、クエリの大文字と小文字は区別されます。

    SELECT s."name" from S3Object s

例 #2: クエリ対象の Amazon S3 オブジェクトには NAME という 1 つのヘッダーまたは属性と、name という別のヘッダーまたは属性があります。

  • 次の式は 400 エラー AmbiguousFieldName を返します。引用符がないため、クエリの大文字と小文字は区別されませんが、2 つの一致があるため、エラーがスローされます。

    SELECT s.name from S3Object s

  • 次の式は、オブジェクトから値を正常に返します。引用符があるため、クエリの大文字と小文字が区別されるため、あいまいさはありません。

    SELECT s."NAME" from S3Object s

ユーザー定義の用語としての予約キーワードの使用

Amazon S3 Select には、オブジェクトのコンテンツのクエリに使用する SQL 式を実行するために必要な予約キーワードのセットがあります。予約キーワードには、関数名、データ型、演算子などが含まれます。場合によっては、列ヘッダー (CSV ファイルの場合) や属性 (JSON オブジェクトの場合) などのユーザー定義の用語が、予約キーワードと競合する可能性があります。その場合は、二重引用符を使用して、予約キーワードと競合するユーザー定義の用語を意図的に使用していることを示す必要があります。そうしないと、400 解析エラーが発生します。

予約キーワードの詳細なリストについては、「予約キーワード」を参照してください。

次の例は、1) Amazon S3 オブジェクトが CSV 形式で、指定された列ヘッダーを持ち、クエリリクエストに対して FileHeaderInfo が "Use" に設定されているか、2) Amazon S3 オブジェクトが JSON 形式で、指定された属性を持っています。

例: クエリ対象のオブジェクトに、予約キーワードである CAST という名前のヘッダーまたは属性があります。

  • 次の式は、オブジェクトから値を正常に返します。クエリで引用符が使用されているため、S3 Select はユーザー定義のヘッダーまたは属性を使用します。

    SELECT s."CAST" from S3Object s

  • 次の式は 400 解析エラーを返します。クエリで引用符が使用されていないため、CAST は予約キーワードと競合します。

    SELECT s.CAST from S3Object s

スカラー式

WHERE 句および SELECT リスト内では、スカラー値を返す式である SQL スカラー式を持つことができます。それには以下の形式があります。

  • literal

    SQL リテラル。

  • column_reference

    形式が column_name または alias.column_name である列への参照。

  • unary_op expression

    この場合、unary_op は SQL 単項演算子です。

  • expression binary_op expression

    この場合、binary_op は SQL 二項演算子です。

  • func_name

    この場合、func_name は、呼び出すスカラー関数の名前です。

  • expression [ NOT ] BETWEEN expression AND expression

  • expression LIKE expression [ ESCAPE expression ]