# tSnowflakeBulkExec

フォルダ内のファイルからSnowflakeテーブルにデータをロードします。フォルダーは、内部Snowflakeステージ、Amazon Simple Storage Service(Amazon S3)バケット、またはAzureコンテナーに配置できます。

通常、tSnowflakeOutputBulkとtSnowflakeBulkExecコンポーネントは、次の2段階のプロセスで連携して機能します。

1. tSnowflakeOutputBulkコンポーネントは、受信データをストレージにアップロードします。
2. tSnowflakeBulkExecコンポーネントは、ストレージからSnowflakeデータベーステーブルにデータをロードします。

この2段階のプロセスで、データベーステーブルにロードする前にデータを変換できます。これらの2つのステップは、別のセクションで詳しく説明されているtSnowflakeOutputBulkExecコンポーネントで融合されています。

情報メモ注:

デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。

## tSnowflakeBulkExecの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtSnowflakeBulkExecを設定するために使われます。

標準のtSnowflakeBulkExecコンポーネントは、Cloudファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で利用できます。

情報メモ注: このコンポーネントは、動的データベースコネクターの特定のバージョンです。データベース設定に関連するプロパティは、データベースタイプの選択に応じて異なります。動的データベースコネクターについては、[DB Genericコンポーネント](https://help.qlik.com/talend/r/ja-JP/8.0/components/db-generic/db-generic-component)をご覧ください。

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| データベース | 目的のデータベースタイプをリストから選択し、[Apply] (適用)をクリックします。 |
| [Property Type] (プロパティタイプ) | 接続の詳細を設定する方法を選択します。<br><br><ul> <li> <span>[Built-In] (組み込み)</span>: このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。 </li> <li> <span>[Repository] (リポジトリー)</span>: <span><span>[Repository] (リポジトリー)</span><abbr> &gt; </abbr><span>[Metadata] (メタデータ)</span></span>で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。このチェックボックスの横にある <span>[...]</span> ボタンをクリックし、表示された <span>[Repository Content] (リポジトリーのコンテンツ)</span>ダイアログボックスで、再使用する接続の詳細をオンにすると、関連するすべての接続のプロパティに値が自動的に入力されます。 </li> </ul><br><br>このプロパティは、[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合に利用できます。 |
| [Connection Component] (接続コンポーネント) | このコンポーネントで再利用するデータベース接続を開くコンポーネントを選択します。 |
| [Account] (アカウント) | [Account] (アカウント)フィールドに、Snowflakeによって割り当てられたアカウント名を二重引用符で囲んで入力します。<br><br>このフィールドは、[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合にのみ利用できます。 |
| [Authentication Type] (認証タイプ) | 認証タイプを設定するために使われます。<br><br><ul> <li> <p> <span>[Basic] (基本)</span>: キーペア認証が有効でない場合は、このオプションを選択します。 </p> </li> <li> <p> <span>[Key Pair] (キーペア)</span>: キーペア認証が有効な場合は、このオプションを選択します。</p> <p>関連情報は、<a href="https://docs.snowflake.net/manuals/user-guide/jdbc-configure.html#using-key-pair-authentication" target="_blank">[Using Key Pair Authentication] (キーペア認証を使う)</a>をご覧ください。</p> </li> <li> <p> <span>OAuth 2.0</span>: このオプションをオンにすると、データアクセスで外部OAuthを使用できます。</p> <p>関連情報は、<a href="https://docs.snowflake.com/en/user-guide/oauth-ext-overview.html" target="_blank">外部OAuthの概要</a>をご覧ください。</p> </li> </ul><br><br>情報メモ注: [Key Pair] (キーペア)オプションを選択する前に、tSetKeyStoreコンポーネントの[Basic settings] (基本設定)ビューでキーペア認証データが次のように設定済みであることを確認します。<br><br><ol> <li><span>[TrustStore type] (TrustStoreタイプ)</span>フィールドをそのままにしておきます。</li> <li><span>[TrustStore file] (TrustStoreファイル)</span>を<kbd>""</kbd>に設定します。</li> <li><span>[TrustStore password] (TrustStoreパスワード)</span>フィールドをクリアします。</li> <li><span>[Need Client authentication] (クライアント認証が必要)</span>を選択します。</li> <li>KeyStoreファイルへのパスを二重引用符で囲んで<span>[KeyStore file] (KeyStoreファイル)</span>フィールドに入力します(または<span>[KeyStore file] (KeyStoreファイル)</span>フィールドの右側にある<span>[…]</span>ボタンをクリックして、KeyStoreファイルに移動します)。</li> <li>KeyStoreファイルのパスワードを<span>[KeyStore password] (KeyStoreパスワード)</span>フィールドに入力します。</li> <li><span>[Check server identity] (サーバーIDをチェック)</span>オプションをクリアします。</li> </ol> |
| [OAuth token endpoint] (OAuthトークンエンドポイント) | OAuth 2.0トークンエンドポイントを入力します。<br><br>このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 |
| [Client ID] (クライアントID) | アプリケーションのクライアントIDを入力します。<br><br>このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 |
| [Client Secret] (クライアントシークレット) | アプリケーションのクライアントシークレットを入力します。<br><br>このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 |
| [Grant type] (付与タイプ) | アクセストークン取得のために付与タイプを設定します。[Client Credentials] (クライアント認証情報)と[Password] (パスワード)という2つのオプションがあります。<br><br>関連情報は、[クライアント認証情報](https://tools.ietf.org/html/rfc6749#section-1.3.4)と[リソース所有者のパスワード認証情報](https://tools.ietf.org/html/rfc6749#section-1.3.3)をご覧ください。<br><br>このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 |
| [OAuth username] (OAuthユーザー名) | OAuthユーザー名を入力します。<br><br>このオプションは、[Grant type] (付与タイプ)ドロップダウンリストから、パスワードが選択されている場合に利用できます。 |
| [OAuth password] (OAuthパスワード) | OAuthパスワードを入力します。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力した後、[OK]クリックして設定を保存します。<br><br>このオプションは、[Grant type] (付与タイプ)ドロップダウンリストから、パスワードが選択されている場合に利用できます。<br><br>情報メモ注: OAuthパスワードではスペースがサポートされていません。 |
| [Scope] (スコープ) | スコープを入力します。関連情報は[スコープ](https://docs.snowflake.com/en/user-guide/oauth-ext-overview.html#scopes)をご覧ください。<br><br>このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 |
| [User Id] (ユーザーID)と[Password] (パスワード) | Snowflakeにログインするための認証情報を二重引用符で囲んで入力します。<br><br><ul> <li> <p><span>[User ID]</span>フィールドに、Snowflakeの<em>LOGIN_NAME</em>パラメーターを使って、Snowflakeで定義されているログイン名を二重引用符で囲んで入力します。詳細は、Snowflakeシステムの管理者にお問い合わせください。</p> </li> <li> <p>パスワードを入力するためには、パスワードフィールドの横にある<span>[...]</span>ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して<span>[OK]</span>をクリックし、設定を保存します。</p> </li> </ul><br><br>このフィールドは、[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合にのみ利用できます。 |
| [Warehouse] (ウェアハウス) | 使用するSnowflakeウェアハウスの名前を二重引用符で囲んで入力します。この名前では大文字と小文字が区別され、Snowflakeでは通常は大文字です。<br><br>このフィールドは、[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合にのみ利用できます。 |
| [Schema] (スキーマ) | 使用するデータベーススキーマの名前を二重引用符で囲んで入力します。この名前では大文字と小文字が区別され、Snowflakeでは通常は大文字です。<br><br>このフィールドは、[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合にのみ利用できます。 |
| [Database] (データベース) | 使用するSnowflakeデータベースの名前を二重引用符で囲んで入力します。この名前では大文字と小文字が区別され、Snowflakeでは通常は大文字です。<br><br>このフィールドは、[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合にのみ利用できます。 |
| [Table] (テーブル) | [...]ボタンをクリックし、表示されるウィザードで、使用するSnowflakeテーブルを選択します。<br><br>新しいテーブルにデータをロードするには、ウィザードで[Use custom object] (カスタムオブジェクトを使う)を選択し、[Object Name] (オブジェクト名)フィールドに新しいテーブルの名前を入力します。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br>[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。<br><br>[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。<br><br>処理するSnowflake データ型がVARIANT(変数)、OBJECT(オブジェクト)、またはARRAY(配列)の場合は、コンポーネントでスキーマを定義する際にスキーマエディターウィザードの[Type] (タイプ)カラムの対応するデータで[String] (文字列)を選択します。<br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul><br><br>null不可能なプリミティブフィールドの入力値がnullの場合、そのフィールドを含むデータ行は拒否されることにご注意ください。<br><br>このコンポーネントはダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)をご覧ください。<br><br>ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。 |
| [Table Action] (テーブルアクション) | テーブルで実行するアクションを選択します。<br><br><ul> <li> <span>[NONE] (なし)</span>: テーブルをそのままにしておきます。</li> <li> <span>[DROP_CREATE]</span>: テーブルを削除し、再作成します。</li> <li> <span>[CREATE] (作成)</span>: 新しいテーブルを作成します。</li> <li> <span>[CREATE_IF_NOT_EXISTS]</span>: テーブルが存在しない場合は作成します。</li> <li> <span>[DROP_IF_EXISTS_AND_CREATE]</span>: テーブルが既に存在する場合は削除し、再作成します。</li> <li> <span>[CLEAR] (クリア)</span>: テーブル内のすべてのデータレコードを削除します。</li> <li> <span>[TRUNCATE] (切り詰め)</span>: テーブル内のすべての行を削除します。このアクションにより、テーブルが占めているスペースが解除されます。</li> </ul> |
| [Output Action] (出力アクション) | Snowflakeデータベーステーブル内の受信データとデータレコードに対して実行する操作を選択します。Snowflakeテーブルのデータを挿入、削除、アップデート、マージできます。このオプションでは、[Table] (テーブル)フィールド内で指定したSnowflakeテーブルが既に存在することを想定しています。<br><br><ul> <li> <span>[INSERT] (挿入)</span>: Snowflakeテーブルに新しいレコードを挿入します。 <div><span>情報メモ</span><span>注:</span> この操作はSnowflakeの<span>COPY INTO</span>コマンドを使います。それによって一時テーブルの使用が中止されるほか、現在のところデータ検証がサポートされていないため、拒否されたレコードを取得する時に予期しない結果が生じることがあります。関連情報は、<a href="https://docs.snowflake.com/en/user-guide/data-load-transform.html" target="_blank">Transforming Data During a Load</a>をご覧ください。</div></li> <li> <span>[UPDATE] (アップデート)</span>: Snowflakeテーブルの既存のレコードをアップデートします。</li> <li> <span>[UPSERT] (アップサート)</span>: 新しいレコードを作成し、既存のレコードをアップデートします。<span>[Upsert Key Column] (キーカラムのアップサート)</span>ドロップダウンリストから、スキーマカラムを結合キーに指定するか、または<span>[Advanced settings] (詳細設定)</span>ビューで<span>[Use schema keys for upsert] (スキーマキーをアップサートに使う)</span>を選択することでスキーマキーを操作に使うように指定する必要があります。 <div><span>情報メモ</span><span>注:</span> <span>[Upsert Key Column] (キーカラムのアップサート)</span>ドロップダウンリストは、<span>[Use schema keys for upsert] (スキーマキーをアップサートに使う)</span>が選択されていない場合に利用できます。</div></li> <li> <span>[DELETE] (削除)</span>: Snowflakeテーブルからレコードを削除します。</li> </ul> |
| [Storage] (ストレージ) | データをテーブルにロードするストレージのタイプを選択します。<br><br><ul> <li> <span>[Internal] (内部)</span>: 内部Snowflakeストレージフォルダーに保管されているファイルからデータをロードします。また、<span>[Stage Folder] (ストレージフォルダー)</span>内の二重引用符で囲まれたフォルダーを指定する必要があります。</li> <li> <span>[S3]</span>: Amazon S3バケットの下にあるフォルダーに保管されているファイルからデータをロードします。また、<span>[Region] (リージョン)</span>、<span>[Access Key] (アクセスキー)</span> (二重引用符内)、<span>[Secret Key] (シークレットキー)</span>、<span>[Bucket] (バケット)</span> (二重引用符内)、<span>[Folder] (フォルダー)</span> (二重引用符内)を含め、S3ユーザーアカウントに関する情報も入力が必要です。</li> <li> <span>[Azure]</span>: [Azure]フォルダーに保管されているファイルからデータをロードします。また、<span>[Protocol] (プロトコル)</span>、<span>[Account Name] (アカウント名)</span> (二重引用符内)、<span>[Container] (コンテナー)</span> (二重引用符内)、<span>[Folder] (フォルダー)</span> (二重引用符内)、<span>[SAS Token] (SASトークン)</span>を含め、Azureユーザーアカウントに関する情報も入力が必要です。</li> </ul> |
| ステージフォルダー | データのロード元とする内部ストレージのSnowflakeステージフォルダーを指定します。<br><br>このフィールドは、[Basic settings] (基本設定)ビューの[Storage] (ストレージ)ドロップダウンリストで[Internal] (内部)が選択され、[Advanced settings] (詳細設定)ビューで[Use Custom Storage Location] (カスタムストレージの場所を使用)オプションが選択されていない場合のみ利用できます。 |
| [Region] (リージョン) | S3バケットが存在するリージョンを指定します。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、S3を選択した場合に利用できます。 |
| [Access Key] (アクセスキー)および[Secret Key] (シークレットキー) | 使用するAmazon S3バケットへの接続に必要な認証情報を入力します。<br><br>パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、[OK] をクリックして設定を保存します。 |
| Bucket (バケット) | データのロードに使うバケットの名前を入力します。既存のバケットを用意しておく必要があります。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、S3を選択した場合に利用できます。 |
| フォルダー | データのロード元とするフォルダーを入力します(二重引用符内)。<br><br>このフィールドは、[Storage] (ストレージ)ドロップダウンリストからS3またはAzureが選択されている場合に使えます。 |
| [Protocol] (プロトコル) | Azure接続の作成に使うプロトコルを選択します。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、Azureを選択した場合に利用できます。 |
| Account Name (アカウント名) | アクセスする必要があるAzure Storageのアカウント名を入力します(二重引用符内)。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、Azureを選択した場合に利用できます。 |
| [Container] (コンテナー)と[Folder] (フォルダー) | データの保管と管理に使うAzureコンテナーとフォルダーを指定します(二重引用符内)。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、Azureを選択した場合に利用できます。 |
| SASトークン | ストレージアカウント内のオブジェクトに対する制限付きアクセスを付与するSASトークンを指定します。<br><br>SASトークンを入力するには、SASトークンフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、[OK] をクリックして設定を保存します。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、Azureを選択した場合に利用できます。 |

## 詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Additional JDBC Parameters] (追加のJDBCパラメーター) | 作成するデータベース接続に接続の追加プロパティを指定します。プロパティはセミコロンで区切られ、各プロパティはキー-値ペアです。たとえば、*encryption=1;clientname=Talend*になります。<br><br>このフィールドは、[Basic settings] (基本設定)ビューの[Connection Component] (接続コンポーネント)ドロップダウンリストから[Use this Component] (このコンポーネントを使用)を選択し、[Storage] (ストレージ)ドロップダウンリストから[Internal] (内部)を選択した場合にのみ利用できます。 |
| [Login Timeout] (ログインタイムアウト) | Snowflakeのログイン試行のタイムアウト期間を分単位で指定します。この期間内にレスポンスが返されないと、エラーが生成されます。 |
| ロール | Snowflakeセッションを開始するために使用するデフォルトアクセス制御ロールを、二重引用符で囲んで入力します。<br><br>このロールは既に存在していて、Snowflakeへの接続に使用するユーザーIDに付与されている必要があります。このフィールドを空のままにしておくと、PUBLICロールが自動的に付与されます。Snowflakeのアクセス制御モデルについては、[アクセス制御モデルの理解](https://docs.snowflake.net/manuals/user-guide/security-access-control.html)をご覧ください。 |
| [Region ID (Deprecated)] (リージョンID (非推奨)) | たとえば、eu-west-1またはeast-us-2.azureのように、リージョンIDを二重引用符で囲んで入力します。SnowflakeリージョンIDの詳細は、[Supported Cloud Regions](https://docs.snowflake.com/en/user-guide/intro-regions.html)をご覧ください。<br><br>tSnowflakeConnection以外のSnowflakeコンポーネントの場合、このフィールドは[Basic settings] (基本設定)ビューで[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合に利用できます。 |
| [URL suffix] (URLサフィックス) | 目的のSnowflakeカスタムドメインURLを二重引用符で囲んで入力します。Snowflake URL形式の詳細は、[Standard account URLs](https://docs.snowflake.com/en/user-guide/organizations-connect#standard-account-urls)をご覧ください。<br><br>tSnowflakeConnection以外のSnowflakeコンポーネントの場合、このフィールドは[Basic settings] (基本設定)ビューで[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合に利用できます。 |
| [Allow Snowflake to convert columns and tables to uppercase] (Snowflakeによるカラムとテーブルの大文字への変換を許可) | このチェックボックスをオンにすると、定義された小文字のテーブル名とスキーマカラム名が大文字に変換されます。引用符で囲まれていない識別子は、Snowflake識別子構文に一致している必要があります。<br><br>チェックボックスをオフにすると、すべての識別子が自動的に引用符で囲まれます。<br><br>このプロパティは、[Manual Query] (手動クエリー)チェックボックスがオンの場合は利用できません。<br><br>Snowflake識別子構文の詳細は、[識別子構文](https://docs.snowflake.net/manuals/sql-reference/identifiers-syntax.html)をご覧ください。 |
| [Use vectors] (ベクターを使用) | このコンポーネントはベクター検索機能をサポートしています。このオプションを使えば、ベクター検索で使用するベクターデータ型を保持するカラム指定できます。そのためには、[Vector properties] (ベクターのプロパティ)テーブルでカラム名(Column)、スキーマカラムのデータ型(Vector type）、そのサイズ(size)を指定する必要があります。<br><br>Snowflakeベクター検索の詳細は、該当する[Snowflakeのドキュメンテーション](https://docs.snowflake.com/en/sql-reference/data-types-vector)をご覧ください。 |
| [Use schema keys for upsert] (スキーマキーをアップサートに使う) | このオプションをオンにすると、スキーマキーをアップサート操作に使用できます。このオプションは、[Basic settings] (基本設定)ビューで[Output Action] (出力アクション)ドロップダウンリストから、[UPSERT] (アップサート)を選択した場合に利用できます。 |
| [Temporary Table Schema] (一時テーブルスキーマ) | 一時テーブルにスキーマを指定します。<br><br>スキーマは存在している必要があります。 |
| カスタムDBタイプ | このチェックボックスをオンにして、スキーマ内の各カラムにDBタイプを指定します。<br><br>このプロパティは、[Basic settings] (基本設定)の[Table Action] (テーブルアクション)ドロップダウンリストからテーブル作成のアクションを選択した場合のみ利用できます。 |
| [Custom Date type mapping] (カスタムの日付タイプマッピング) | 日付タイプのデータでカスタムマッピングを使用する場合はこのチェックボックスをオンにし、[Convert Date values to] (日付値を次に変換]ドロップダウンリストからマッピングを選択します。<br><br>このオプションは、ダイナミックスキーマを使用しており、[Basic settings] (基本設定)ビューで[Table Action] (テーブルアクション)ドロップダウンリストから次のオプションが選択された場合に利用できます:<br><br><ul> <li> <span>CREATE</span> </li> <li> <span>DROP_CREATE</span> </li> <li> <span>CREATE_IF_NOT_EXISTS</span> </li> </ul> |
| [Delete Storage Files On Success] (成功時にストレージファイルを削除) | データのテーブルへのロードが成功すると、ストレージフォルダー内のすべてのファイルを削除します。<br><br>[Use Custom Storage Location] (カスタムストレージの場所を使用)をオンにすると、このフィールドは使えません。 |
| [Snowflake access to storage] (Snowflakeストレージへのアクセス) | S3バケットにアクセスする時は、COPYコマンドの認証方式を指定します。関連情報は[Additional Cloud Provider Parameters](https://docs.snowflake.com/en/sql-reference/sql/copy-into-table.html#additional-cloud-provider-parameters) (英語版)をご覧ください。<br><br>情報メモ注: このオプションは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから[S3]が選択された場合に利用できます。<br><br><ul> <li> <span>[Credentials] (認証情報)</span>: 認証にS3認証情報を使います。</li> <li> <span>[Storage integration] (ストレージ統合)</span>: 認証にストレージ統合を使います。この場合は<span>[Storage integration] (ストレージ統合)</span>フィールドに統合名を入力します。 </li> </ul> |
| [S3 Assume Role] (S3ロールを引き受け) | AWS IAMロールに関連付けられており、自分のユーザーアカウントに付与されていないアクセス権限を一時的に必要とする場合は、このチェックボックスをオンにすればそのロールを引き受けることができます。その後、次のパラメーターの値を指定して、新しく引き受けたロールセッションを作成します。<br><br>このロールに関連付けられている信頼ポリシーによって、自分のユーザーアカウントにそのロールへのアクセスが付与されていることをご確認ください。不明であれば、そのロールの所有者かAWS管理者にお問い合わせください。<br><br>情報メモ注:<br><br><ul> <li>このオプションは、<span>[Basic settings] (基本設定)</span>ビューで<span>[Storage] (ストレージ)</span>ドロップダウンリストから<kbd>[S3]</kbd>が選択された場合に利用できます。</li> <li>想定されるロールの一時認証情報がus-east-1リージョンの AWS STS から要求されます。</li> </ul><br><br><ul> <li> <p> <span>[Role ARN] (ロールARN)</span>: 引き受けるロールのARN (Amazonリソース名)。このARN名は、AWSポータルで使用するロールの<span>[Summary] (概要)</span>ページで見つかります。このロールARNの形式は、たとえば<kbd>am:aws:iam::[aws_account_number]:role/[role_name]</kbd>となります。 </p> </li> <li> <p> <span>[Role session name] (ロールセッション名)</span>: 引き受けたロールセッションの一意識別に使用する名前を入力します。この名前には英字(大文字と小文字の両方)と数字を利用できますが、スペースを含めることはできません。また、アンダースコア( _ )の他、= , . @ - も使用できます。 </p> </li> <li> <p> <span>[Session duration] (セッション処理時間)</span>: 引き受けたロールセッションをアクティブにする期間(分)。この期間をAWS管理者が設定した最大期間より長くすることはできません。処理時間のデフォルトは15分です。 </p> </li> </ul><br><br><br>IAMロールと関連するポリシータイプの例については、AWSドキュメンテーションで[\[Create and Manage AWS IAM Roles\] (AWS IAMロールの作成と管理)](https://aws.amazon.com/blogs/security/now-create-and-manage-aws-iam-roles-more-easily-with-the-updated-iam-console/)をご覧ください。 |
| S3エラー再試行最大回数 | S3フォルダーとの間でデータの送受信中にエラーが発生した場合のデータロード再試行最大回数を指定します。このパラメーターのデフォルトは3です。-1の値は可能な再試行最大回数を指定します。-1または正の整数のみが認められます。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、S3を選択した場合に利用できます。 |
| Azureエラー再試行最大回数 | Azureフォルダーとの間でデータの送受信中にエラーが発生した場合のデータロード再試行最大回数を指定します。このパラメーターのデフォルトは3です。-1の値は可能な再試行最大回数を指定します。-1または正の整数のみが認められます。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、Azureを選択した場合に利用できます。 |
| カスタムS3接続設定の使用 | カスタムS3設定を使う場合は、このチェックボックスをオンにします。<br><br><ul> <li> <p> <span>[Option] (オプション)</span>: リストからパラメーターを選択します。</p> </li> <li> <p> <span>[Value] (値)</span>: パラメーター値を入力します。</p> </li> </ul><br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、S3を選択した場合に利用できます。 |
| [Use Custom Stage Prefix] (カスタムステージプレフィックスを使用) | データのロード元のフォルダーへのパスを指定する(現在のステージがルートの場合)には、このチェックボックスをオンにします。表示されたフィールドにフォルダーへのパスを入力することも必要です。たとえば、ステージ下の*myfolder1/myfolder2*にあるファイル内に保管されているデータをロードするには、フィールドに"@~/myfolder1/myfolder2"と入力する必要があります。<br><br>このフィールドは、[Basic settings] (基本設定)ビューで[Storage] (ストレージ)ドロップダウンリストから、[Internal] (内部)を選択した場合に利用できます。<br><br>選択すると、[Basic settings] (基本設定)ビュー内の[Stage Folder] (ステージフォルダー)は利用できなくなります。 |
| [Use Custom Storage Location] (カスタムストレージの場所を使用) | データのロード元となる外部ストレージ(S3など)のフォルダーを指定する場合は、このチェックボックスをオンにします。このオプションの横にあるフィールドでフォルダーを指定する必要があります。 |
| コマンドオプションのコピー | ドロップダウンリストから、以下のオプションを選択し、COPY INTOコマンドのパラメーターを設定するために使われます。COPY INTOコマンドはSnowflakeによって提供されます。このコマンドにより、データがSnowflakeデータベーステーブルにロードされます。<br><br><ul> <li> <span>[Default] (デフォルト)</span>: 右側のフレームにリスト表示されているデフォルト設定を使ってCOPY INTO操作を実行します。</li> <li> <span>[Table] (テーブル)</span>: <span>[Options] (オプション)</span>テーブルを使ってCOPY INTO操作パラメーターを設定するために使われます。パラメーターを設定するには、[+]ボタンをクリックし、<span>[Option] (オプション)</span>カラムからパラメーターを選択し、<span>[Value] (値)</span>カラムにパラメーター値を設定するために使われます。</li> <li> <span>[Manual] (手動)</span>: 右側のテキストフレームにCOPY INTO操作パラメーターを手動で設定します。</li> </ul><br><br><br>COPY INTOコマンドのパラメーターについては、[COPY INTOコマンド](https://docs.snowflake.net/manuals/sql-reference/sql/copy-into-table.html)をご覧ください。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## [Global Variables] (グローバル変数)

| 変数 | 説明 |
| --- | --- |
| NB\_LINE | 処理された行数。これはAfter変数で、整数を返します。 |
| NB\_SUCCESS | 正しく処理された行数。これはAfter変数で、整数を返します。 |
| NB\_REJECT | 却下された行数。これはAfter変数で、整数を返します。 |
| ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントはジョブやサブジョブのスタンドアロンコンポーネントとして使えます。 |