GCS Explorer

サポートツール

GCS Explorer は、GCP コンソールを介さずに、BLOCKS から Google Cloud Storage（GCS）のアイテム（ファイルやフォルダー）を閲覧・操作できるツールです。

GCS Explorer では、以下のことができます。

バケットの作成・削除
特定バケット内のアイテムの閲覧
ファイルのアップロード
フォルダーのアップロード（Google Chrome のみ）
フォルダーの作成
アイテムの削除
ファイルのダウンロード
アイテムの GCS URL のコピー
画像ファイルの GCS URL を DataEditor のデータとして追加（DataEditor のライセンスが必要）

グローバルナビゲーションのメニューアイコン（）をクリックし、表示されるメニューから［GCS Explorer］をクリックすると、GCS Explorer の画面に切り替わります。をクリックすると、新しいタブに GCS Explorer が表示されます。

以下、上図の各番号ごとに機能の解説をします。

1. アイテム表示切替

アイテムの表示をリスト形式で表示するか、グリッド形式で表示するかを切り替えます。

アイコン	説明
	アイテムをリスト形式で表示します。画像ファイル名をクリックすると、ポップアップで画像が表示されます。
	アイテムをグリッド形式で表示します。画像ファイルは、サムネイル表示されます。サムネイルをクリックすると、画像がポップアップして表示されます。

アイコン

説明

アイテムをリスト形式で表示します。

画像ファイル名をクリックすると、ポップアップで画像が表示されます。

アイテムをグリッド形式で表示します。

画像ファイルは、サムネイル表示されます。サムネイルをクリックすると、画像がポップアップして表示されます。

画像ファイルとして認識するのは、以下のいずれかです。

ファイルの拡張子が JPG・JPEG・PNG・BMP・GIF・SVG（大文字・小文字の区別なし）
ファイルのタイプ（MIME タイプ）が image/*（例：image/jpeg・image/png など）

2. GCP サービスアカウントの選択

GCS Explorer で GCS へアクセスする GCP サービスアカウントを選択します。

アイコンをクリック
一覧から GCP サービスアカウントをクリック

3. パス

アイテムエリアに表示されているアイテムへのパスが表示されます。

パスは、バケットもしくはフォルダーを特定する文字列で、/ バケット一覧 / foo / bar / baz / のような形式をしています。

パス内の / 以外はクリックできます。

［バケット一覧］の部分をクリックすると、アイテムエリアがバケット一覧に切り替わります。GCP サービスアカウント選択直後のバケットが選択されていないときもバケット一覧が表示されます。

［バケット一覧］以外のバケット名やフォルダー名をクリックすると、アイテムエリアがクリックしたバケットもしくはフォルダーのアイテム一覧に切り替わります。

4. アクションボタン

アイテムを操作するアクションボタンが並びます。

アイテム一覧のときの「テーブルの絵柄のボタン」と「フォルダーに歯車の絵柄のボタン」は、クリックするとメニューが表示されます。

それぞれのボタンとメニューの機能は以下のとおりです。

新しいバケット

バケットを作成します。バケット一覧のときのみ表示されます。

ボタンをクリックすると、バケットを作成するための画面が表示されます。

バケット名（❶）・ストレージクラス（❷）・ロケーション（❸）を指定して、［作成］ボタンをクリックすると、バケットが作成できます。

ファイルダウンロード

ファイルをダウンロードします。

アイテム表示がリスト形式で、アイテムのチェックボックスがチェックされているときのみ表示されます。

ダウンロード対象は、チェックボックスがチェックされているアイテムです（複数アイテムのダウンロード可能）。

アイテム削除

アイテムを削除します。

アイテム表示がリスト形式で、アイテムのチェックボックスがチェックされているときのみ表示されます。

削除対象は、チェックボックスがチェックされているアイテムです（複数アイテム同時に削除可能）。

DataEditor テーブルに列追加

選択したバケットもしくはフォルダー配下の画像ファイルを検索し、その画像ファイルの GCS URL を DataEditor のデータに追加します。この機能は、モデルジェネレーターのマルチモーダル用のデータを作成するのに適しています。

GCS Explorer から GCS URL を DataEditor のデータに追加するイメージ図

対応する画像ファイルは、拡張子が jpg・png・bmp・gif（大文字・小文字の区別なし）のファイルです。このうち、どの拡張子を対象とするかは取捨選択ができます。

パス（GCS URL）中にコンマ（,）を含む画像ファイル名は対象外です。

画像ファイルの検索は、フォルダーの中にフォルダーがある場合は、最下層のフォルダーまで検索します。

この機能の利用にあたっては、以下の前提条件を満たしている必要があります。

DataEditor のライセンスがある
DataEditor にデータ（テーブル）があらかじめ登録されている
テーブルには画像ファイルを検索するための STRING 型のキー列がある
- キー値：画像ファイル名からドット（.）を含めた拡張子を除いた部分
- 例：gs://foo/bar/baz.jpg の場合は、baz がキーとなる

この機能では、GCS URL 列の追加に加え、画像ファイルが存在するフォルダーの名称をラベル列として追加も可能です。

テーブルへの GCS URL 列やラベル列の追加は、既存のテーブルに追加するわけではなく、下図のように既存のテーブルと GCS URL 列やラベル列を結合した新しいテーブルを作成します。

GCS Explorer から GCS URL を DataEditor のテーブルに追加する具体的な図

GCS URL 列とラベル列の列名は、自由に設定できます。

GCS URL 列の位置も自由に設定できます。ラベル位置も追加する場合は、ラベル列の位置は GCS URL 列の 1 つ前になります。

以下は、この機能の画面と各項目の意味です。

項目名	説明
追加するテーブル名	GCS URL 列を追加したい既存の DataEditor テーブルを選択します。先に説明したとおり、GCS URL 列の追加は既存のテーブルに列を追加するわけではなく、既存のテーブルと GCS URL 列やラベル列を結合した新しいテーブルを作成します。
追加する GCS URL の列名	追加する GCS URL 列の列名を指定します。
挿入位置	GCS URL 列の位置を指定します。ラベル列も追加する場合は、ラベル列の位置は GCS URL 列の 1 つ前になります。
対象ファイルの拡張子	対象とする画像ファイルの拡張子を選択します。
フォルダ名をラベル列として追加する	画像ファイルが存在するフォルダーの名称をラベル列として追加する場合は、チェックボックスにチェックを付けます。ラベル列を追加したくない場合は、チェックボックスのチェックを外します。
追加するラベルの列名	ラベル列の列名を指定します。
キー列	［`追加するテーブル名`］で選択したテーブル中の STRING 型のキー列を指定します。
サンプルプレビュー	このボタンをクリックすると、GCS URL 列やラベル列を追加した新しい DataEditor テーブル構成のイメージが確認できます。
データセット ID	新しい DataEditor テーブルの保存先となるデータセットの ID を指定します。
テーブル ID	新しい DataEditor テーブルの保存先となるテーブルの ID を指定します。
名前	新しい DataEditor テーブルの名前を指定します。

ファイルアップロード

ファイルを GCS にアップロードします。

アップロード中であれば、途中でアップロードを中止できます。

画面右下に表示されるアップロード状況から［すべてのアップロードを中止］（❶）をクリックすると、すべてのアップロードを中止できます。各ファイル右端のをクリックすると、当該ファイルのアップロードを中止できます。

大量のファイルを同時にアップロードして、ウェブブラウザーが応答しなくなった場合は、ウェブブラウザーを強制終了させてください。その後、アップロードするファイルの数を減らして再度お試しください。

フォルダアップロード

フォルダーを GCS にアップロードします。Google Chrome のみで使用できます（その他のウェブブラウザーではボタンが表示されません）。

アップロード中であれば、途中でアップロードを中止できます。

フォルダ作成

フォルダーを作成します。

バケットの削除

バケットを削除します。

バケット内にアイテムがあると削除できません。バケットを削除するためには、バケット内のアイテムを［アイテムを削除する］ですべて削除してから行ってください。

5. メッセージ

メッセージが表示されます。メッセージ右端の［×］をクリックすると、メッセージが消せます。

6.アイテム表示

アイテムの一覧がリスト形式もしくはグリッド形式で表示されます。

リスト形式

リスト形式は、以下のように表示されます。

リスト形式での各表示部分の意味と使い方は以下のとおりです。

項目	説明
選択ボックス	チェックボックスのチェックのオン／オフで、アイテムの選択／非選択を切り替えます。
名前	アイテム名です。アイテムが画像ファイルの場合は、ファイル名をクリックすると、画像がポップアップして表示されます。 ❶ 部分のアイコンをクリックすると、画像ファイルを別タブに表示したり（タイプが `image/` のもの）、画像ファイルをダウンロードできます（タイプが `image/` 以外のもの）。 ❷および❸の部分をクリックすると、前後の画像ファイルをそのまま閲覧できます。画像ファイルとして認識するのは、以下のいずれかです。ファイルの拡張子が JPG・JPEG・PNG・BMP・GIF・SVG（大文字・小文字の区別なし）ファイルのタイプ（MIME タイプ）が image/*（例：image/jpeg・image/png など）
サイズ	ファイルのサイズです。
タイプ	アイテムのタイプです。アイテムがフォルダーの場合は、Folder と表示されます。アイテムがファイルの場合は、そのファイルの MIME タイプが表示されます。
最終更新日時	最後にファイルを更新した日時です。
	をクリックすると、アイテムのタイプに応じて以下のメニューが表示されます。［`URL をコピー`］：アイテムの GCS URL（`gs://my-bucket/myitem.png` のような形式）がクリップボードにコピーされます。［`パスをコピー`］：アイテムの GCS URL から `gs://` を除いた文字列がクリップボードにコピーされます。アイテムの GCS URL が、`gs://my-bucket/foo/bar.png` の場合、`my-bucket/foo/bar.png` がクリップボードにコピーされます。［`ダウンロード`］：当該アイテムがダウンロードできます。一般のファイルと、ファイルタイプ（MIME タイプ）が image/* 以外の画像ファイルが対象です。［`別タブで開く`］：当該アイテムが別タブで開きます。ファイルタイプ（MIME タイプ）が image/* の画像ファイルが対象です。

グリッド形式

グリッド形式は、以下のように表示されます。

グリッド形式での各表示部分の意味と使い方は以下のとおりです。

項目	説明
	フォルダーの表示です。クリックすると、そのフォルダー内のアイテム表示に切り替わります。
	一般的なファイルの表示です。
	画像ファイルの表示です。クリックすると、画像がポップアップして表示されます。 ❶ 部分のアイコンをクリックすると、画像ファイルを別タブに表示したり（タイプが image/* のもの）、画像ファイルをダウンロードできます（タイプが image/* 以外のもの）。 ❷および❸の部分をクリックすると、前後の画像ファイルをそのまま閲覧できます。画像ファイルとして認識するのは、以下のいずれかです。ファイルの拡張子が JPG・JPEG・PNG・BMP・GIF・SVG（大文字・小文字の区別なし）ファイルのタイプ（MIME タイプ）が image/*（例：image/jpeg・image/png など）
	をクリックすると、アイテムのタイプに応じて以下のメニューが表示されます。［`パスをコピー`］：アイテムの GCS URL から `gs://` を除いた文字列がクリップボードにコピーされます。アイテムの GCS URL が、`gs://my-bucket/foo/bar.png` の場合、`my-bucket/foo/bar.png` がクリップボードにコピーされます。［`ダウンロード`］：当該アイテムがダウンロードできます。一般のファイルと、ファイルタイプ（MIME タイプ）が image/* 以外の画像ファイルが対象です。［`別タブで開く`］：当該アイテムが別タブで開きます。ファイルタイプ（MIME タイプ）が image/* の画像ファイルが対象です。