# tGSCopy

Google Cloud Storageのバケット内またはバケット間でオブジェクトをコピーまたは移動します。

tGSCopyは、コピータスクを自動化することでプロセスを合理化します。

## tGSCopyの標準プロパティ

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

標準のtGSCopyコンポーネントは、ビッグデータファミリーと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アクセストークン)を使って認証する場合のみ利用できます。 |
| [Source bucket name] (ソースバケット名) | オブジェクトのコピー元または移動元のバケットの名前を指定します。 |
| [Project ID] (プロジェクトID) | 資格情報の種類が[OAuth Access Token] (OAuthアクセストークン)に設定されている場合は、オブジェクトのコピー元または移動元としたいプロジェクトIDを指定します。 |
| [Source object key] (ソースオブジェクトキー) | コピーするオブジェクトのキーを指定します。 |
| [Source is folder] (ソースはフォルダー) | ソースオブジェクトがフォルダーの場合は、このチェックボックスをオンにします。 |
| [Target bucket name] (ターゲットバケット名) | オブジェクトのコピー先または移動先のバケットの名前を指定します。 |
| [Target folder] (ターゲットフォルダー) | オブジェクトのコピー先または移動先のフォルダーを指定します。 |
| [Action] (アクション) | オブジェクトに対して実行するアクションをリストから選択します。<br><br><ul> <li> <p> <span>[Copy] (コピー)</span>: オブジェクトをソースバケットまたはフォルダーからターゲットバケットまたはフォルダーにコピーします。</p> </li> <li> <p> <span>[Move] (移動)</span>: オブジェクトをソースバケットまたはフォルダーからターゲットバケットまたはフォルダーに移動します。</p> </li> </ul> |
| [Rename] (名前の変更) | このチェックボックスをオンにして、[New name] (新しい名前)フィールドに、コピーまたは移動するオブジェクトの新しい名前を入力します。<br><br>[Source is folder] (ソースはフォルダー)チェックボックスをオンにした場合、[Rename] (名前の変更)チェックボックスは利用できません。 |
| [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] (アプリケーションのデフォルト認証情報)を使って認証する場合のみ利用できます。 |
| [Use source path] (ソースパスを使用) | このチェックボックスをオンにすると、同じバケットや複数のバケットにある項目をコピーまたは移動する時にパスが追加されます。<br><br>[Basic settings] (基本設定)ビューで[Rename] (名前を変更)チェックボックスをオンにすると、[Use source path] (ソースパスを使用)オプションが動作しなくなります。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

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

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | SOURCE\_BUCKET: ソースバケットの名前。これはAfter変数で、文字列を返します。<br><br>SOURCE\_OBJECTKEY: ソースオブジェクトのキー。これはAfter変数で、文字列を返します。<br><br>DESTINATION\_BUCKETNAME: デスティネーションバケットの名前。これはAfter変数で、文字列を返します。<br><br>DESTINATION\_FOLDER: デスティネーションフォルダー。これは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)をご覧ください。 |

## 使用方法

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

**関連概念**

* [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)