# tGSDelete

Google Cloud Storageの指定された条件に一致するオブジェクトを削除して、占有されているリソースを解放します。

## tGSDeleteの標準プロパティ

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

標準のtGSDeleteコンポーネントは、ビッグデータファミリーと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アクセストークン)を使って認証する場合のみ利用できます。 |
| [Key prefix] (キープレフィックス) | 指定されたプレフィックスで始まるキーを持つオブジェクトのみを削除するには、プレフィックスを指定します。 |
| [Delimiter] (区切り) | 区切りまでのキー名を持つオブジェクトのみを削除するには、区切りを指定します。 |
| [Specify project ID] (プロジェクトIDを指定) | 認証情報タイプが[OAuth Access Token] (OAuthアクセストークン)に設定されている場合は、このチェックボックスをオンにし、オブジェクトの削除元としたいプロジェクトIDを[Project ID] (プロジェクトID)フィールドに入力します。 |
| [Delete object from bucket list] (バケットリストからオブジェクトを削除) | このチェックボックスをオンにして[Buchet] (バケット)テーブルに入力し、指定したバケット内のオブジェクトを削除します。<br><br><ul> <li> <p> <span>[Bucket name] (バケット名)</span>: オブジェクトを削除するバケットの名前を入力します。</p> </li> <li> <p> <span>[Key prefix] (キープレフィックス)</span>: 指定したバケットから指定したプレフィックスで始まるキーを持つオブジェクトを削除するには、プレフィックスを入力します。</p> </li> <li> <p> <span>[Delimiter] (区切り)</span>: 区切りまでのキー名を持つオブジェクトを指定のバケットから削除するには、区切りを入力します。</p> </li> </ul><br><br>[Delete object from bucket list] (バケットリストからオブジェクトを削除)チェックボックスをオンにすると、[Key prefix] (キープレフィックス)と[Delimiter] (区切り)フィールド、[Specify project ID] (プロジェクトIDを指定)チェックボックスは利用できなくなります。 |
| [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] (アプリケーションのデフォルト認証情報)を使って認証する場合のみ利用できます。 |
| [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)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントをtGSListコンポーネントと共に使って、指定した条件に一致するオブジェクトが正しく削除されたかどうかを確認できます。 |

**関連概念**

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