# tSnowflakeInputの標準プロパティ これらのプロパティは、標準ジョブのフレームワークで実行されているtSnowflakeInputを設定するために使われます。 標準のtSnowflakeInputコンポーネントは、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)をご覧ください。

ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。 | | [Manual Query] (手動クエリー) | このチェックボックスをオンにし、[Full SQL query string] (SQLクエリー文字列の全文)フィールドに、実行するクエリーステートメントを二重引用符で囲んで入力します。Snowflake SQLコマンドについては、[SQL Command Reference](https://docs.snowflake.net/manuals/sql-reference-commands.html)をご覧ください。

このコンポーネントはベクター検索機能をサポートしています。このオプションでは、Snowflakeで前に作成されたベクターを使ってクエリー条件を指定できます。

Snowflakeベクター検索の詳細は、該当する[Snowflakeのドキュメンテーション](https://docs.snowflake.com/en/sql-reference/data-types-vector)をご覧ください。 | | Condition | Snowflakeテーブルのデータをフィルタリングするために使用するブール式を二重引用符で囲んで入力します。この式は、tSnowflakeInputにより実行されるSELECTクエリーのWHERE句として実際に使用されます。 | ## 詳細設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | [Additional JDBC Parameters] (追加のJDBCパラメーター) | 作成するデータベース接続に接続の追加プロパティを指定します。プロパティはセミコロンで区切られ、各プロパティはキー-値ペアです。たとえば、*encryption=1;clientname=Talend*になります。

このフィールドは、[Basic settings] (基本設定)ビューの[Connection Component] (接続コンポーネント)ドロップダウンリストから[Use this Component] (このコンポーネントを使用)を選択し、[Storage] (ストレージ)ドロップダウンリストから[Internal] (内部)を選択した場合にのみ利用できます。 | | [Login Timeout] (ログインタイムアウト) | Snowflakeのログイン試行のタイムアウト期間を分単位で指定します。この期間内にレスポンスが返されないと、エラーが生成されます。

このフィールドは、[Basic settings] (基本設定)ビューの[Connection Component] (接続コンポーネント)ドロップダウンリストから[Use this Component] (このコンポーネントを使用)を選択し、[Storage] (ストレージ)ドロップダウンリストから[Internal] (内部)を選択した場合にのみ利用できます。 | | ロール | Snowflakeセッションを開始するために使用するデフォルトアクセス制御ロールを、二重引用符で囲んで入力します。

このロールは既に存在していて、Snowflakeへの接続に使用するユーザーIDに付与されている必要があります。このフィールドを空のままにしておくと、PUBLICロールが自動的に付与されます。Snowflakeのアクセス制御モデルについては、[アクセス制御モデルの理解](https://docs.snowflake.net/manuals/user-guide/security-access-control.html)をご覧ください。

このフィールドは、[Basic settings] (基本設定)ビューの[Connection Component] (接続コンポーネント)ドロップダウンリストから[Use this Component] (このコンポーネントを使用)を選択し、[Storage] (ストレージ)ドロップダウンリストから[Internal] (内部)を選択した場合にのみ利用できます。 | | [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] (このコンポーネントを使用)を選択した場合に利用できます。 | | [Use unquoted object identifiers] (引用符で囲まれていないオブジェクト識別子を使う) | 引用符で囲まれていないテーブル名とスキーマカラム名を使う場合は、このチェックボックスをオンにします。引用符で囲まれていない識別子は、Snowflake識別子構文に一致している必要があります。Snowflake識別子構文に一致しないカラム名またはテーブル名は、このチェックボックスがオンの場合でも引用符に囲まれます。

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

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

Snowflake識別子構文については、[識別子の要件](https://docs.snowflake.net/manuals/sql-reference/identifiers-syntax.html)をご覧ください。 | | [Use session timezone] (セッションタイムゾーンを使用) | JVMタイムゾーンではなく、セッションタイムゾーンを使用する場合は、このチェックボックスをオンにします。デフォルトでは、このオプションは選択されていません。 | | [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 | ## [Global Variables] (グローバル変数) | 変数 | 説明 | | --- | --- | | NB\_LINE | 処理された行数。これはAfter変数で、整数を返します。 | | ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 | ## 使用方法 | 使用方法のガイダンス | 説明 | | --- | --- | | **使用ルール** | このコンポーネントは、ジョブ内のデータフローの開始コンポーネントです。このコンポーネントは、[Row] (行)リンクを介して他のコンポーネントにデータを送信します。 |