GCSDelete - Google Cloud Storageからオブジェクトを削除
Google Cloud Storageからオブジェクトを削除します。
Google Cloud Storageへの認証にはサービスアカウントを使用します。サービスアカウントの使用方法は下記トピック「認証に必要な準備」を参照してください。
■ストリーム情報
| 入力 | フォーマット | すべて | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 接続数 | 無制限 | ||||||||||||
| 説明 | 入力ストリームは使用せず、すべて無視します。 | ||||||||||||
| 出力 | フォーマット | Record | |||||||||||
| 説明 |
次のようなフィールド定義の固定のレコードが出力されます。
|
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| コネクションを使用 | boolean | - |
接続先に以下のコネクション名を使用するかどうか選択します。
|
||||||
| コネクション名 | connection | - | コネクションを使用が「はい」の場合に、GCPコネクションを指定します。 コネクションペインまたは管理コンソールにて作成されたGCPコネクションを選択します。 | ||||||
| コネクション情報 | group | - | コネクションを使用プロパティが「いいえ」の場合に使用されるプロパティ群です。 | ||||||
| メールアドレス | string | 入力＆出力 | Google Developer Consoleから取得したサービスアカウントのメールアドレスを設定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 | ||||||
| 証明書のエイリアス | string | 入力＆出力 |
サービスアカウント認証用の証明書のエイリアスを設定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 |
||||||
| アプリケーション名 | string | 入力＆出力 |
Google Cloud Storageのアプリケーション名を設定します。 Google Cloud Platformのプロジェクト名ではなく、アプリケーションを区別するための名前です。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 |
||||||
| タイムアウト（秒） | int | 入力＆出力 |
リクエスト時およびコネクション接続時のタイムアウトまでの時間を秒単位で指定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 |
||||||
| プロキシ設定を使用 | boolean | - |
管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。 プロキシの認証には対応していません。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。
|
||||||
| バケット名 | string | 入力＆出力 | オブジェクトを削除するバケットの名前を指定します。 | ||||||
| オブジェクト名 | string | 入力＆出力 |
削除するオブジェクトの名前を指定します。 フォルダーを削除する場合、「folder_name/」の形式で指定します。 |
||||||
| サブフォルダーを含める | boolean | 入力＆出力 | オブジェクト名で指定されたフォルダーより深い階層にあるオブジェクトを処理に含めるかどうかを選択します。 フォルダーを削除する場合のみ有効です。
|
||||||
| ループを開始 | loopProcess | 入力＆出力 |
結果をまとめて出力するか、ループして出力するかを選択します。
|
||||||
| 成功件数 | int | 出力 |
削除に成功した件数が出力されます。 |
||||||
| 失敗件数 | int | 出力 |
削除に失敗した件数が出力されます。 |
■ループ処理
削除対象のオブジェクトが複数あり、ループを開始が「はい」の場合、 このコンポーネントがループの起点となってレコードを1つずつ出力します。
■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
| タイプ | パラメーター | エラー処理フロー へのストリーム | エラー コード | 説明 |
|---|---|---|---|---|
| 汎用 | なし | コンポーネントの入力ストリーム | 2 | 通信に失敗した場合 |
| 3 | オブジェクトへのアクセス権がなかった場合 | |||
| 4 | 証明書の取得に失敗した場合 | |||
| 5 | プロパティが不正だった場合 | |||
| 7 | 出力ストリームのフィールドのデータ型の定義が不正だった場合 | |||
| オブジェクトが無い | なし | コンポーネントの入力ストリーム | 6 | オブジェクトが存在しない場合 |
■削除するオブジェクトが存在しなかった場合
オブジェクト名に指定したオブジェクトがファイルで、そのファイルが存在しなかった場合は、出力ストリームのMessageフィールドにエラーメッセージが設定されてフローは正常終了します。それに対して、オブジェクト名に指定したオブジェクトがフォルダーで、そのフォルダーが存在しなかった場合は、上記のエラーが発生します。
■認証に必要な準備
Google Cloud Storage系コンポーネントを使用するには、Google Developer Consoleからサービスアカウントを作成して認証情報を取得し、管理コンソールで設定する必要があります。
- Google Developer Consoleの「認証情報」でサービスアカウントを追加する
- P12形式の証明書を選択してダウンロードする
- 管理コンソールでP12証明書をユーザーの証明書としてインポートする
- サービスアカウントのメールアドレスとインポートした証明書をコンポーネントの接続情報に設定する
■動作に必要な設定
Google Cloud Storage系コンポーネントを使用するには、Google APIs Client Libraries for Javaが必要です。
- Assembly for the Google APIs Client Library for Javaからgoogle-api-client-assembly-1.31.2-1.31.2.zipファイルをダウンロードしてください。
- ダウンロードしたzipファイルを解凍し、次のjarファイルを[DATA_DIR]/system/lib/userlibフォルダーにコピーしてください。
- google-api-client-1.31.2.jar
- google-http-client-1.38.1.jar
- google-http-client-jackson2-1.38.1.jar
- google-oauth-client-1.31.4.jar
- grpc-context-1.22.1.jar
- guava-30.1-android.jar
- opencensus-api-0.24.0.jar
- opencensus-contrib-http-util-0.24.0.jar
- Could Storage JSON API Libraryのダウンロードページから最新版のjarファイルをダウンロードしてください。（最新版の詳細ページのFilesという項目にjarファイルのダウンロードリンクがあります）
- ダウンロードした次のjarファイルを[DATA_DIR]/system/lib/userlibフォルダーにコピーしてください。
- google-api-services-storage-v1-rev[version]-[version].jar
■バケットとオブジェクトの設定画面
コンポーネントをダブルクリックするか、右クリックメニューの「Google Cloud Storage Browser」を実行することで、コンポーネントに設定されている接続情報を使用して設定画面が開きます。
この画面ではバケット名とオブジェクト名の設定とバケットの新規作成、そしてバケットとオブジェクトの削除を行うことができます。
まず最初に「プロジェクト」にプロジェクトIDかプロジェクトのナンバーを入力してから「バケットリスト」ボタンをクリックしてください。
「バケット」ツリーリスト
バケットとオブジェクトのツリーリストが表示されます。
このリストの中からコンポーネント設定するバケットとオブジェクトを選択します。
「プロジェクト」
バケットのプロジェクトを指定します。
プロジェクトのIDかナンバーを指定してください。プロジェクト名には対応していません。
コンポーネントのバケット名が指定されている場合、そのバケットが所属するプロジェクトのナンバーが表示されます。
「バケットリスト」ボタン
指定したプロジェクトのバケットリストを表示します。
バケット名
選択したバケットの値が表示されます。
オブジェクト名
選択したオブジェクトの値が表示されます。
「バケットを作成」ボタン
バケットを作成するためのダイアログが表示されます。
「バケットを削除」ボタン
「バケット」ツリーリストで選択されているバケットをサーバーから削除します。
「オブジェクトを削除」ボタン
「バケット」ツリーリストで選択されているオブジェクトをサーバーから削除します。
属性情報
選択されているバケットまたはオブジェクトの属性情報が表示されます。
ファイル内容はUTF-8で表示します。それ以外のエンコーディングではうまく表示できない場合があります。
「OK」ボタン
リストで選択されたバケットとオブジェクトの情報をコンポーネントのバケット名とオブジェクト名プロパティに設定します。
「キャンセル」ボタン
このダイアログを閉じます。
コンポーネントのバケット名とオブジェクト名プロパティに変更はありません。