# tGSPut

ファイルをGoogle Cloud Storageで管理できるように、ローカルディレクトリーからGoogle Cloud Storageにファイルをアップロードします。

## tGSPutの標準プロパティ

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

標準のtGSPutコンポーネントは、ファミリーとビッグデータCloudに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Use an existing connection] (既存の接続を使用) | 定義済みの接続の詳細を再利用するには、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)で該当する接続コンポーネントをクリックします。 |
| [Credential type] (認証情報のタイプ) | プロジェクトの認証に使用されるモードを選択します。<br><br><ul> <li><span>[Service account] (サービスアカウント)</span>: Google Cloud Platformプロジェクトに関連付けられているGoogleアカウントを使って認証します。このモードを選択すると、アクセスキーは<span>[Service account credentials file] (サービスアカウントキー)</span>フィールドに入力する必要があります。</li> <li><span>ワークロードIDフェデレーション</span>: サービスアカウントキーを使用することなく、AWS、Azure、OIDCなどの外部IDプロバイダーを使用して認証を行います。このモードを選択する場合、IDフェデレーションの設定は、[<span>クライアントライブラリ設定ファイル</span>]フィールドで指定する必要があります。</li> <li><span>[Application Default Credentials] (アプリケーションのデフォルト認証情報)</span>: アプリケーションのデフォルト認証情報を使って認証します。このモードを選択した場合、アプリケーション環境に基づいて認証情報が自動的に検索されるので、追加のパラメーターを定義する必要はありません。</li> <li> <span>[OAuth Access Token] (OAuth アクセストークン)</span>: OAuthアクセストークンを使用して認証します。このモードを選択する場合、トークンは[<span>OAuthアクセストークン</span>]フィールドに情報を提供する必要があります。 </li> </ul><br><br>Google Cloudの認証プロセスに関する詳細は、[Google Cloudのドキュメンテーション](https://cloud.google.com/docs/authentication/)をご参照ください。 |
| [Service account key] (サービスアカウントキー) | サービスアカウントキーフィールドの横にある[...]ボタンをクリックして、サービスアカウントキーを含むJSONファイルを参照します。<br><br>このプロパティは、サービスアカウントを使って認証する場合のみ利用できます。 |
| [OAuth Access Token] (OAuthアクセストークン) | アクセストークンを入力します。<br><br>トークンのライフタイムは1時間です。コンポーネントは、トークン更新操作を行いませんが、1時間という制限時間を超えても操作できるよう、新しいアクセストークンをフェッチします。<br><br><br>このプロパティは、[OAuth Access Token] (OAuthアクセストークン)を使って認証する場合のみ利用できます。 |
| [Bucket name] (バケット名) | ファイルをアップロードするバケットの名前を入力します。 |
| [Project ID] (プロジェクトID) | 資格情報の種類が[OAuth Access Token] (OAuthアクセストークン)に設定されている場合は、ファイルのアップロード先とするプロジェクトIDを指定します。 |
| [Local directory or file] (ローカルディレクトリーまたはファイル) | アップロードするファイルを格納するローカルのファイルやディレクトリーの完全パスを入力するか参照します。<br><br>[Use files list] (ファイルリストを使用)チェックボックスがオンの場合、このフィールドで指定できるのはディレクトリーのみです。<br><br>[Use files list] (ファイルリストを使用)チェックボックスがオフであれば、このフィールドでファイルでもディレクトリーでも指定できます。 |
| Google Storage directory (Google Storageディレクトリー) | ファイルをアップロードするGoogle Storagedディレクトリーを入力します。 |
| Use files list (ファイルリストを使用) | このチェックボックスをオンにし、アップロードするファイルを使って[Files] (ファイル)テーブルを完成させます。<br><br><ul> <li> <p> <span>[Filemask] (ファイルマスク)</span>: アップロードしたいファイルに一致するパターンを入力します。 </p> <p>ファイル名の一部を入力する場合は、"*" 文字を使えばファイル名の任意の文字数を置き換えることができます。 </p> <p>たとえば<span>sales_*.csv</span>と入力すると、<span>sales_112023.csv</span>と<span>sales_122023.csv</span>の両方が検索されます。                         </p> </li> <li> <p> <span>[New name] (新しい名前)</span>: アップロードするファイルの新しい名前を入力します。</p> </li> </ul> |
| Die on error (エラー発生時に強制終了) | このチェックボックスはデフォルトでオフになっています。すなわち、エラーが発生した行をスキップし、エラーが発生していない行のプロセスを完了させます。 |

## 詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Use a custom endpoint] (カスタムエンドポイントを使用) | デフォルトのエンドポイントの代わりにプライベートエンドポイントを使う場合は、このチェックボックスをオンにします。<br><br>選択後は、https://storage.goggleapis.comという形式でGoogle Storage Private API URLプロパティにURLを入力します。<br><br>詳細は、Googleのドキュメンテーションで[Access Google APIs through endpoints](https://cloud.google.com/vpc/docs/configure-private-service-connect-apis)をご覧ください。<br><br>このプロパティは、[Service account] (サービスアカウント)と[Application Default Credentials] (アプリケーションのデフォルト認証情報)を使って認証する場合のみ利用できます。 |
| ーツサイズ(Mb) | パーツにオブジェクトをアップロードする場合は、パーツサイズを(MB単位で)指定します。プロパティは次のように機能します。<br><br><ul> <li> <p>値が0の場合、オブジェクトはパーツに分割されずにアップロードされます。 </p> </li> <li> <p>値が0より大きい場合、パーツサイズより大きいオブジェクトがパーツにアップロードされます。</p> </li> <li> <p>値が0の場合、オブジェクトはパーツに分割されずにアップロードされます。</p> </li> </ul><br><br>値が0の時は、ファイルの大きさが2147483647バイトを超えないようにしてください。<br><br>このオプションは、どの認証情報タイプでも利用可能です。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

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

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | NB\_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。<br><br>ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、他のコンポーネント、特にtGSGetコンポーネントと併用できます。 |

**関連概念**

* [Google Cloud Storageでのファイル管理](https://help.qlik.com/talend/ja-JP/components/8.0/gs/tgscopy-tgslist-tlogrow-managing-files-with-google-cloud-storage-standard-component-the)