表記規則

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

重要

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

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

構文、例、テキスト

表記

説明

ITEM、 ITEM

文字すべてが大文字の場合は、Snowflake SQL コマンド、キーワード、パラメーター名、関数名を表します。

アイテム、 item

文字すべてが小文字の場合は、ユーザーが提供する識別子、パラメーター、または引数の値を表します。

<アイテム>アイテム

山括弧と斜体は、ユーザーが提供する識別子、パラメーター、または引数を表します。

( item1 item2 ... )

パラメーターまたは引数をグループ化するために、 SQL では括弧が使用されます。

コマンドを入力するときは、括弧が 必須 です(表示されるとおりに 正確に 入力する必要あり)。

{ item1 item2 ... }

中括弧は、識別子、パラメーター、または引数のグループ化を表します。

中括弧は、複数の選択肢がある場合に選択肢を区切るために垂直バーとともに使用されます。

どちらの場合も、中括弧は入力 しない でください。

[ ITEM ][ item1 item2 ... ]

角括弧は、ステートメントのオプション部分を表します。これらは、入力 しない でください。

多くの場合においてデフォルト値が提供されるため、角括弧内の項目はオプションです。

|

垂直バーは通常、角括弧または中括弧内の2つ以上の項目または値の間の選択を表します。角括弧または中括弧は、入力 しない でください。

... (省略記号)

前の項目は無限に繰り返すことができます。

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

BEGIN [ WORK ]

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

BEGIN;
BEGIN WORK;

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

BEGIN [ { WORK | TRANSACTION } ]

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

BEGIN;
BEGIN WORK;
BEGIN TRANSACTION;

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

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

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

create function my_function(my_argument integer)

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

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

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

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

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

JSON データ

表記

説明

[ item1 ... ]

角括弧は、 JSON 配列の区切り文字です。

{ item1 item2 ... }

中括弧は、 JSON オブジェクトの区切り文字です。

XML データ

表記

説明

<アイテム> ... </アイテム>

山括弧は、 XML 要素の開始または終了を表します。