tGSGetの標準プロパティ

[Use an existing connection] (既存の接続を使用)

定義済みの接続の詳細を再利用するには、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)で該当する接続コンポーネントをクリックします。

プロジェクトの認証に使用されるタイプを選択します。

• [HMAC key (deprecated) ] (HMACキー (非推奨) ): Oauth認証情報を使用して認証します。この認証情報のタイプを選択した場合、[Basic settings] (基本設定)ビューで定義されるパラメーターは[Access Key] (アクセスキー)と[Secret Key] (秘密キー)になります。
• [Service account] (サービスアカウント): Googleアカウントを使用して認証します。この認証情報タイプを選択した場合、[Basic settings] (基本設定)ビューで定義されるパラメーターは[Service account key] (サービスアカウントキー)になります。
• [OAuth Access Token] (OAuth アクセストークン): OAuthアクセストークンを使用して認証します。この認証情報タイプを選択した場合、[Basic settings] (基本設定)ビューで定義されるパラメーターは[OAuth Access Token] (OAuthアクセストークン)になります。

Googleクラウドストレージに対してリクエストする、Googleから取得した認証情報を入力します。

これらのキーはGoogleAPIコンソールから、プロジェクトの[Google Cloud Storage] (Goolgleクラウドストレージ)タブの[Interoperable Access] (相互運用可能アクセス)タブビューで確認できます。

シークレットキーを入力するには、シークレットキーフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにシークレットキーを二重引用符の間に入力し、OKをクリックして設定を保存します。

アクセスキーとシークレットキーの詳細は、https://developers.google.com/storage/docs/reference/v1/getting-startedv1?hl=en/にアクセスし、開発者キーについての説明をご覧ください。

この2つのフィールドは、[Credential type] (認証情報タイプ)ドロップダウンリストで[HMAC key (deprecarted)] (HMAC キー(非推奨))が選択されていて、[Using an existing connection] (既存の接続を使用)チェックボックスがオフの場合に利用できます。

[Service account key] (サービスアカウントキー)フィールドの横にある[...]ボタンをクリックして、サービスアカウントキーを含むJSONファイルを参照します。

このフィールドは、[Credential type] (認証情報タイプ)ドロップダウンリストで[Service account] (サービスアカウント)が選択されていて、[Using an existing connection] (既存の接続を使用)チェックボックスがオフの場合に利用できます。

アクセストークンを入力します。

アクセストークンのライフタイムは1時間です。コンポーネントは、トークン更新操作を行いませんが、1時間という制限時間を超えても操作できるよう、新しいアクセストークンをフェッチします。

このフィールドは、[Credential type] (認証情報タイプ)ドロップダウンリストで[OAuth Access Token] (OAuthアクセストークン)が選択されていて、[Using an existing connection] (既存の接続を使用)チェックボックスがオフの場合に利用できます。

[Key prefix] (キープレフィックス)

指定されたプレフィックスで始まるキーを持つオブジェクトのみをダウンロードするには、プレフィックスを指定します。

区切りまでのキー名を持つオブジェクトのみをダウンロードするには、区切りを指定します。

[Specify project ID] (プロジェクトIDを指定)

認証情報タイプが[HMAC key] (HMACキー)または[OAuth Access Token] (OAuthアクセストークン)に設定されている場合は、このチェックボックスをオンにして、[Project ID] (プロジェクトID)フィールドに、オブジェクトを取得するプロジェクトIDを入力します。

[Use keys] (キーを使用)

このチェックボックスをオンにして[Keys] (キー)テーブルに入力し、Google Cloud Storageからダウンロードするオブジェクトの条件を定義します。

• [Bucket name] (バケット名): オブジェクトをダウンロードするバケットの名前を入力します。

• [Key] (キー): ダウンロードするオブジェクトのキーを入力します。

• [New name] (新しい名前): ダウンロードするオブジェクトの新しい名前を入力します。

[Use keys] (キーを使用)チェックボックスをオンにすると、[Key prefix] (キープレフィックス)と[Delimiter] (区切り)フィールド、[Specify project ID] (プロジェクトIDを指定)チェックボックス、[Get files from bucket list] (バケットリストを指定してファイルを取得)チェックボックスは利用できなくなります。

[Get files from bucket list] (バケットリストを指定してファイルを取得)

このチェックボックスをオンにして[Bucket] (バケット)テーブルに入力し、Google Cloud Storageからダウンロードするオブジェクトの条件を定義します。

• [Bucket name] (バケット名): オブジェクトをダウンロードするバケットの名前を入力します。

• [Key prefix] (キープレフィックス): 指定したバケットから指定したプレフィックスで始まるキーを持つオブジェクトをダウンロードするには、プレフィックスを入力します。

• [Delimiter] (区切り): 区切りまでのキー名を持つオブジェクトを指定のバケットからダウンロードするには、区切りを指定します。

[Get files from bucket list] (バケットリストを指定してファイルを取得)チェックボックスをオンにすると、[Key prefix] (キープレフィックス)と[Delimiter] (区切り)フィールド、[Specify project ID] (プロジェクトIDを指定)チェックボックス、[Use keys] (キーを使用)チェックボックスは利用できなくなります。

[Output directory] (出力ディレクトリー)

ダウンロードしたオブジェクトを保管するディレクトリーを指定します。

[Die on error] (エラー発生時に強制終了)

このチェックボックスはデフォルトでオフになっています。すなわち、エラーが発生した行をスキップし、エラーが発生していない行のプロセスを完了させます。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。

グローバル変数

NB_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。

ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。

Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入れるには、Ctrl + スペースを押して変数リストにアクセスし、リストから使用する変数を選択します。

変数の詳細は、Studio Talendユーザーガイドをご覧ください。

使用ルール

このコンポーネントは、通常、他のGoogle Cloud Storageコンポーネント、特にtGSPutと共に使います。