# tSnowflakeOutputの標準プロパティ これらのプロパティは、標準ジョブのフレームワークで実行されているtSnowflakeOutputを設定するために使われます。 標準のtSnowflakeOutputコンポーネントは、Cloudファミリーに属しています。 このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。 情報メモ注: このコンポーネントは、動的データベースコネクターの特定のバージョンです。データベース設定に関連するプロパティは、データベースタイプの選択に応じて異なります。動的データベースコネクターについては、[DB Genericコンポーネント](https://help.qlik.com/talend/r/ja-JP/8.0/components/db-generic/db-generic-component)をご覧ください。 ## 基本設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | データベース | 目的のデータベースタイプをリストから選択し、[Apply] (適用)をクリックします。 | | [Property Type] (プロパティタイプ) | 接続の詳細を設定する方法を選択します。



[Connection Component] (接続コンポーネント)ドロップダウンリストから、他の接続コンポーネントを選択した場合、このプロパティは、利用できません。 | | [Connection Component] (接続コンポーネント) | このコンポーネントで再利用するデータベース接続を開くコンポーネントを選択します。 | | [Account] (アカウント) | [Account] (アカウント)フィールドに、Snowflakeによって割り当てられたアカウント名を二重引用符で囲んで入力します。 | | [Authentication Type] (認証タイプ) | 認証タイプを設定するために使われます。



情報メモ注: [Key Pair] (キーペア)オプションを選択する前に、tSetKeyStoreコンポーネントの[Basic settings] (基本設定)ビューでキーペア認証データが次のように設定済みであることを確認します。

  1. [TrustStore type] (TrustStoreタイプ)フィールドをそのままにしておきます。
  2. [TrustStore file] (TrustStoreファイル)を""に設定します。
  3. [TrustStore password] (TrustStoreパスワード)フィールドをクリアします。
  4. [Need Client authentication] (クライアント認証が必要)を選択します。
  5. KeyStoreファイルへのパスを二重引用符で囲んで[KeyStore file] (KeyStoreファイル)フィールドに入力します(または[KeyStore file] (KeyStoreファイル)フィールドの右側にある[…]ボタンをクリックして、KeyStoreファイルに移動します)。
  6. KeyStoreファイルのパスワードを[KeyStore password] (KeyStoreパスワード)フィールドに入力します。
  7. [Check server identity] (サーバーIDをチェック)オプションをクリアします。
| | [OAuth token endpoint] (OAuthトークンエンドポイント) | OAuth 2.0トークンエンドポイントを入力します。

このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 | | [Client ID] (クライアントID) | アプリケーションのクライアントIDを入力します。

このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 | | [Client Secret] (クライアントシークレット) | アプリケーションのクライアントシークレットを入力します。

このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 | | [Grant type] (付与タイプ) | アクセストークン取得のために付与タイプを設定します。[Client Credentials] (クライアント認証情報)と[Password] (パスワード)という2つのオプションがあります。

関連情報は、[クライアント認証情報](https://tools.ietf.org/html/rfc6749#section-1.3.4)と[リソース所有者のパスワード認証情報](https://tools.ietf.org/html/rfc6749#section-1.3.3)をご覧ください。

このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 | | [OAuth username] (OAuthユーザー名) | OAuthユーザー名を入力します。

このオプションは、[Grant type] (付与タイプ)ドロップダウンリストから、パスワードが選択されている場合に利用できます。 | | [OAuth password] (OAuthパスワード) | OAuthパスワードを入力します。

パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力した後、[OK]クリックして設定を保存します。

このオプションは、[Grant type] (付与タイプ)ドロップダウンリストから、パスワードが選択されている場合に利用できます。

情報メモ注: OAuthパスワードではスペースがサポートされていません。 | | [Scope] (スコープ) | スコープを入力します。関連情報は[スコープ](https://docs.snowflake.com/en/user-guide/oauth-ext-overview.html#scopes)をご覧ください。

このオプションは、[Authentication Type] (認証タイプ)ドロップダウンリストから、OAuth 2.0が選択されている場合に利用できます。 | | [User Id] (ユーザーID)と[Password] (パスワード) | Snowflakeにログインするための認証情報を二重引用符で囲んで入力します。

| | [Warehouse] (ウェアハウス) | 使用するSnowflakeウェアハウスの名前を二重引用符で囲んで入力します。この名前では大文字と小文字が区別され、Snowflakeでは通常は大文字です。 | | [Schema] (スキーマ) | 使用するデータベーススキーマの名前を二重引用符で囲んで入力します。この名前では大文字と小文字が区別され、Snowflakeでは通常は大文字です。 | | [Database] (データベース) | 使用するSnowflakeデータベースの名前を二重引用符で囲んで入力します。この名前では大文字と小文字が区別され、Snowflakeでは通常は大文字です。 | | [Table] (テーブル) | [...]ボタンをクリックし、表示されるウィザードで、使用するSnowflakeテーブルを選択します。 | | [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。

[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

処理するSnowflake データ型がVARIANT(変数)、OBJECT(オブジェクト)、またはARRAY(配列)の場合は、コンポーネントでスキーマを定義する際にスキーマエディターウィザードの[Type] (タイプ)カラムの対応するデータで[String] (文字列)を選択します。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。



null不可能なプリミティブフィールドの入力値がnullの場合、そのフィールドを含むデータ行は拒否されることにご注意ください。

このコンポーネントはダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)をご覧ください。

ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。 | | [Table Action] (テーブルアクション) | テーブルで実行するアクションを選択します。

| | [Output Action] (出力アクション) | Snowflakeデータベーステーブル内の受信データとデータレコードに対して実行する操作を選択します。Snowflakeテーブルのデータを挿入、削除、アップデート、マージできます。このオプションでは、[Table] (テーブル)フィールド内で指定したSnowflakeテーブルが既に存在することを想定しています。

| | Die on error (エラー発生時に強制終了) | このオプションを選択して、エラーが発生した時にジョブの実行を終了します。このオプションをオフにして、エラーの発生した行をスキップし、エラーが発生していない行の処理を完了させます。

このオプションは[Row > Reject] (行 > リジェクト)接続で動作できません。 | ## 詳細設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | [Additional JDBC Parameters] (追加のJDBCパラメーター) | 作成するデータベース接続に追加のJDBCパラメーターを指定します。 | | [Login Timeout] (ログインタイムアウト) | Snowflakeのログイン試行のタイムアウト期間を分単位で指定します。この期間内にレスポンスが返されないと、エラーが生成されます。 | | ロール | Snowflakeセッションを開始するために使用するデフォルトアクセス制御ロールを、二重引用符で囲んで入力します。

このロールは既に存在していて、Snowflakeへの接続に使用するユーザーIDに付与されている必要があります。このフィールドを空のままにしておくと、PUBLICロールが自動的に付与されます。Snowflakeのアクセス制御モデルについては、[アクセス制御モデルの理解](https://docs.snowflake.net/manuals/user-guide/security-access-control.html)をご覧ください。 | | [URL suffix] (URLサフィックス) | 目的のSnowflakeカスタムドメインURLを二重引用符で囲んで入力します。Snowflake URL形式の詳細は、[Standard account URLs](https://docs.snowflake.com/en/user-guide/organizations-connect#standard-account-urls)をご覧ください。

tSnowflakeConnection以外のSnowflakeコンポーネントの場合、このフィールドは[Basic settings] (基本設定)ビューで[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合に利用できます。 | | [Allow Snowflake to convert columns and tables to uppercase] (Snowflakeによるカラムとテーブルの大文字への変換を許可) | このチェックボックスをオンにすると、定義された小文字のテーブル名とスキーマカラム名が大文字に変換されます。引用符で囲まれていない識別子は、Snowflake識別子構文に一致している必要があります。

チェックボックスをオフにすると、すべての識別子が自動的に引用符で囲まれます。

このプロパティは、[Manual Query] (手動クエリー)チェックボックスがオンの場合は利用できません。

Snowflake識別子構文の詳細は、[識別子構文](https://docs.snowflake.net/manuals/sql-reference/identifiers-syntax.html)をご覧ください。 | | [Convert empty strings to null] (空の文字列をNullに変換) | 空の文字列をNullに変換するには、このオプションを選択します。 | | [Use existing database schema as the dynamic schema] (既存のデータベーススキーマをダイナミックスキーマとして使用) | ダイナミックスキーマ機能を使用している場合にこのチェックボックスをオンにすれば、(テーブルが存在する場合は)データベース自体からスキーマを選べるようになれます。このオプションが選択されていなければ、デフォルトでは入力スキーマが選択されていません。 | | [Use schema keys for upsert] (スキーマキーをアップサートに使う) | このオプションをオンにすると、スキーマキーをアップサート操作に使用できます。このオプションは、[Basic settings] (基本設定)ビューで[Output Action] (出力アクション)ドロップダウンリストから、[UPSERT] (アップサート)を選択した場合に利用できます。 | | カスタムDBタイプ | このチェックボックスをオンにして、スキーマ内の各カラムにDBタイプを指定します。

このプロパティは、[Basic settings] (基本設定)の[Table Action] (テーブルアクション)ドロップダウンリストからテーブル作成のアクションを選択した場合のみ利用できます。 | | ダイナミックスキーマを持つテーブル作成用のカスタムの日付タイプのマッピング | ダイナミックスキーマ機能を使用している場合は、このチェックボックスを選択して日付タイプのデータにカスタムマッピングを適用し、[Convert Date values to] (日付値を次に変換]ドロップダウンリストからマッピングを選択します。

このオプションは、[Basic settings] (基本設定)ビューで[Table Action] (テーブルアクション)ドロップダウンリストから次のオプションを選択した場合に利用できます。

| | [Use schema date pattern] (スキーマの日付パターンを使用) | スキーマで定義されている日付パターンを使ってDate型のスキーマカラム内のデータを変換するには、このオプションを選択します。このためには、[Custom DB Type] (カスタムDBタイプ)フィールドで、スキーマカラムのDBタイプをSTRING、TEXT、またはVARCHARに指定することも必要です。 | | [Use vectors] (ベクターを使用) | このコンポーネントはベクター検索機能をサポートしています。このオプションを使えば、ベクター検索で使用するベクターデータ型を保持するカラム指定できます。そのためには、[Vector properties] (ベクターのプロパティ)テーブルでカラム名(Column)、スキーマカラムのデータ型(Vector type）、そのサイズ(size)を指定する必要があります。

Snowflakeベクター検索の詳細は、該当する[Snowflakeのドキュメンテーション](https://docs.snowflake.com/en/sql-reference/data-types-vector)をご覧ください。 | | [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 | ## [Global Variables] (グローバル変数) | 変数 | 説明 | | --- | --- | | NB\_LINE | 処理された行数。これはAfter変数で、整数を返します。 | | NB\_SUCCESS | 正しく処理された行数。これはAfter変数で、整数を返します。 | | NB\_REJECT | 却下された行数。これはAfter変数で、整数を返します。 | | ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 | ## 使用方法 | 使用方法のガイダンス | 説明 | | --- | --- | | **使用ルール** | このコンポーネントは、ジョブ内のデータフローの終了コンポーネントです。このコンポーネントは、[Row] (行) > [Main] (メイン)リンクからデータを受け取ります。

[Row] (行) > [Rejects] (リジェクト)リンクを介してエラーメッセージを他のコンポーネントに送信することもできます。エラーについて示される情報の例は次のとおりです。

|