表記規則¶

Snowflakeのドキュメントでは、次の表記規則が使用されています。

重要

構文とコードの説明では、山括弧（< >）、角括弧（[ ]）、中括弧（{ }）、垂直バー（|）は表記目的のみに使用されています。構文エラーを回避するには、コマンドの入力時またはコードの記述時にそれらを含めないでください。

ただし、 JSON と XML では、括弧と中括弧は特定の意味を持つため、 JSON または XML のドキュメント/データを使用する場合は含める必要があります。

構文、例、テキスト¶

表記	説明
ITEM、 `ITEM`	文字すべてが大文字の場合は、Snowflake SQL コマンド、キーワード、パラメーター名、関数名を表します。
アイテム、 `item`	文字すべてが小文字の場合は、ユーザーが提供する識別子、パラメーター、または引数の値を表します。
<アイテム>、 `item`	山括弧と斜体は、ユーザーが提供する識別子、パラメーター、または引数を表します。
`( item1 item2 ... )`	パラメーターまたは引数をグループ化するために、 SQL では括弧が使用されます。コマンドを入力するときは、括弧が必須です（表示されるとおりに正確に入力する必要あり）。
`{ item1 item2 ... }`	中括弧は、識別子、パラメーター、または引数のグループ化を表します。中括弧は、複数の選択肢がある場合に選択肢を区切るために垂直バーとともに使用されます。どちらの場合も、中括弧は入力しないでください。
`[ ITEM ]`、 `[ item1 item2 ... ]`	角括弧は、ステートメントのオプション部分を表します。これらは、入力しないでください。多くの場合においてデフォルト値が提供されるため、角括弧内の項目はオプションです。
`\|`	垂直バーは通常、角括弧または中括弧内の2つ以上の項目または値の間の選択を表します。角括弧または中括弧は、入力しないでください。
`...` （省略記号）	前の項目は無限に繰り返すことができます。

例¶

以下では、キーワード WORK はオプションです。

BEGIN [ WORK ]

Copy

したがって、次のいずれかが有効です。

BEGIN;
BEGIN WORK;

Copy

以下では、キーワード WORK またはキーワード TRANSACTION のいずれかを使用できます。両方は使用しないでください。両方を省略することはできます。

BEGIN [ { WORK | TRANSACTION } ]

Copy

したがって、次のいずれかが有効です。

BEGIN;
BEGIN WORK;
BEGIN TRANSACTION;

Copy

以下に、1つの引数を受け入れる関数呼び出しの構文を示します。括弧は必須です。 <関数名>、 <引数名>、および <データ型> は、実際の名前に置き換える必要があります。

create function <function_name>( <argument_name> <data_type> )

Copy

したがって、以下が有効です。

create function my_function(my_argument integer)

Copy

以下は、少なくとも1つの引数を必要とし、オプションの追加の引数を受け入れる関数を示しています。

<function_name>( <argument_name> <data_type> [ , <argument_name> data_type ] ... )

Copy

したがって、以下が有効です。

my_function(argument_1 integer)
my_function(argument_1 integer, argument_2 integer)
my_function(argument_1 integer, argument_2 integer, argument_3 varchar)

Copy

この場合、追加の引数も許可されます。

JSON データ¶

表記	説明
`[ item1 ... ]`	角括弧は、 JSON 配列の区切り文字です。
`{ item1 item2 ... }`	中括弧は、 JSON オブジェクトの区切り文字です。

XML データ¶

表記	説明
`<アイテム> ... </アイテム>`	山括弧は、 XML 要素の開始または終了を表します。