チェーンの一部としてSnowflake®データベースで構造化クエリ言語（SQL）操作を実行するには、Snowflake接続コマンドを含むステップを追加します。
これらのコマンドを有効にするには、IT 管理者がまずSnowflake JDBC コネクタ を作成します。
作成の実行
CREATE 文を実行するには、Execute create コマンドを使用する。
プロパティ
| プロパティ |
詳細 |
| SQLテキスト/ファイル |
実行するSQLテキストまたはファイルを入力します。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
無効な入力 |
| 3 |
エラー |
コマンドの実行に失敗しました。 |
クエリの実行
SELECT クエリを実行し、その結果をカンマ区切り値（CSV）ファイルとして生成するには、クエリ実行 コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| SQLテキスト/ファイル |
実行するSQLテキストまたはファイルを入力します。 |
| 区切り記号 |
CSV出力で使用する区切り文字を選択します。 |
| プレビュー結果 |
返却された行のプレビューを見るには、このボックスをチェックします。 |
出力
| 出力 |
出力タイプ |
| レコード数 |
整数 |
| 結果設定 (CSV) |
ファイル |
| SQLエラー |
JSON |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
無効な入力 |
| 3 |
エラー |
コマンドの実行に失敗しました。 |
SQLの実行
任意のSQLコマンドを実行するには、Execute SQL コマンドを使用する。どのような結果設定もファイル出力として利用できます。
プロパティ
| プロパティ |
詳細 |
| SQLテキスト/ファイル |
実行するSQLテキストまたはファイルを入力します。 |
出力
| 出力 |
出力タイプ |
| レコード数 |
整数 |
| 結果設定 (CSV) |
ファイル |
| 記録更新 |
整数 |
| SQLエラー |
JSON |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
無効な入力 |
| 3 |
エラー |
コマンドの実行に失敗しました。 |
アップデートの実行
UPDATE ステートメントを実行するには、Execute update コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| SQLテキスト/ファイル |
実行するSQLテキストまたはファイルを入力します。 |
出力
| 出力 |
出力タイプ |
| 記録更新 |
整数 |
| SQLエラー |
JSON |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
無効な入力 |
| 3 |
エラー |
コマンドの実行に失敗しました。 |
テーブル定義の取得
テーブルの詳細（列、プライマリ・キー、外部キーを含む）をJSONとして取得するには、Get table definition コマンドを使用する。
プロパティ
| プロパティ |
詳細 |
| テーブル |
定義を取得するテーブルを入力します。 |
出力
| 出力 |
出力タイプ |
| テーブルのメタデータ |
ファイル |
| SQLエラー |
JSON |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
無効な入力が行われた |
| 3 |
エラー |
コマンドの実行に失敗しました。 |
レコードの挿入
INSERT ステートメントを実行するには、Insert records コマンドを使用する。データのソースは、複数行のテキストまたはCSVファイルです。
プロパティ
| プロパティ |
詳細 |
| テーブル |
レコードを挿入するテーブルを入力する。 |
| CSVデータソース |
テーブルに挿入するCSVファイルを入力します。CSVファイルの列は、Columns で指定した順序と同じでなければならない。 |
| 区切り記号 |
CSV データソース で使用する区切り記号を選択する。 |
| ファイルである |
CSVデータソース がファイルの場合は、このボックスにチェックを入れる。 |
| ヘッダーを含む |
CSVデータソース の最初の行がヘッダーの場合は、このボックスをチェックします。 |
| 列 |
CSVデータソース が入力する列のリストを入力します。順序は重要で、CSVデータソースと一致させる必要がある。 |
| 値テンプレート |
INSERT コマンドのカスタム値宣言を入力する。?で値を示します。?の数は、ターゲットのフィールド数と同じでなければならない。自動生成する場合は空白のままにしてください。 |
出力
| 出力 |
出力タイプ |
| 挿入された記録 |
整数 |
| SQLエラー |
JSON |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
無効な入力 |
| 3 |
エラー |
コマンドの実行に失敗しました。 |
レコードのアップサート
UPSERT ステートメントを実行するには、Upsert records コマンドを使用する。既存のレコードの一意キーがデータ・ソース内のレコードの一意キーと一致する場合、コマンドはそのレコードを更新し、そうでない場合はそのレコードを挿入します。
プロパティ
| プロパティ |
詳細 |
| 対象テーブル |
レコードをアップサートするテーブルを入力する。 |
| ステージングテーブル（自動生成） |
ターゲット・テーブルにアップサートされるレコードを一時的に保持するテーブルの名称を入力する。 注： 既存のテーブルを使用しないでください。コマンドは自動的にテーブルを作成し、アップサート中にドロップします。 |
| ユニークな列 |
各レコードに固有の値を含む列のリストを入力します。これらの列がステージング・テーブルとターゲット・テーブルの両方のレコード間で一致する場合、コマンドはレコードを更新します。そうでない場合は、レコードを挿入します。 |
| CSVデータソース |
ターゲットテーブルにアップサートする複数行テキストまたは CSV ファイルを入力します。このデータソースの列は、Columns と同じ順序でなければならない。 |
| 区切り記号 |
CSV データソース で使用する区切り記号を選択する。 |
| ファイルである |
CSVデータソース 入力がCSVファイルの場合、このボックスにチェックを入れる。 |
| ヘッダーを含む |
CSVデータソース 入力がヘッダー行で始まる場合、このボックスをチェックする。 |
| 列 |
CSV データソース 入力が入力する列のリストを、CSV データソース と同じ順序で入力する。 |
| 値テンプレート |
UPSERT 文のカスタマイズ値を入力する。?で値を示します。?の数は、ターゲットのフィールド数と同じでなければならない。自動生成する場合は空白のままにしてください。 |
出力
| 出力 |
出力タイプ |
| 記録更新 |
整数 |
| SQLエラー |
JSON |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
無効な入力が行われた |
| 3 |
エラー |
コマンドの実行に失敗しました。 |