Google Cloud Storage

Google Cloud Storage 上のファイルを、データソースとして登録できます。

必要な情報

接続情報(必須)

Google Cloud Storage 必要な情報は以下の通りです。

バケット(必須)

Google Cloud Storage のバケット名を入れます。gs://nehan/node_log/2022-01-01.csv を対象にするなら、nehan がバケットです。

ファイルキー(必須)

バケット名より後ろの部分を入れます。

1 ファイルを指定する場合

gs://nehan/node_log/2022-01-01.csv を対象にするなら、node_log/2022-01-01.csv がファイルキーです。

複数ファイルを一括で指定する場合

前が一致するファイルがまとめて対象になります。 node_log/2022-01 と入れれば、次のファイルがすべて取り込まれ、縦に積まれて 1 つのデータソースになります。

node_log/2022-01-01.csv
node_log/2022-01-02.csv
node_log/2022-01-03.csv
...

列の並びが違っていてもまとめられます。詳しくは複数ファイル一括読み込みを見てください。

サフィックス(任意)

ファイルキーで絞り込んだファイルを、さらに後ろの字で絞ります。 .csv と入れれば、.csv で終わるファイルだけが対象になります。拡張子でなくてもよく、_jp.csv のような書き方もできます。

空のままだと絞り込みません。ファイルキーの下に読めない形式のファイルが混ざっているときは、ここで外しておくとエラーを防げます。

末尾が / のもの（フォルダそのもの）は、いつも対象から外れます。

差分読み込み

画面の右上にある差分読み込みのスイッチで切り替えます。チェックボックスではありません。入れると、前回読み込んだファイルは読み直さず、増えたファイルだけを読み足します。隣の読み込み済みファイルを押すと、これまでに読み込んだファイルの一覧と、それぞれの読み込み日時が見られます。

データソースの更新差分読み込みの使いどころと具体例

うまくいかないとき

バケットがない

バケットに入れた名前が Google Cloud Storage 側にないときに出ます。

指定されたバケットが見つかりません。バケット名が正しいか確認してください。

直し方 — バケット名の綴りを確かめてください。gs:// や末尾の / は入れません。

権限が足りない

サービスアカウントにそのバケットを読む権限がないときに出ます。

アクセスが拒否されました。アクセス権限をご確認ください。

直し方 — GCP コンソールで、接続情報に使ったサービスアカウントにバケットの閲覧権限を付けてください。

サービスアカウントキーが使えない

キーの期限が切れているか、無効にされているときに出ます。

接続情報が不正です。サービスアカウントキーの認証に失敗しました。サービスアカウントキーが期限切れまたは無効になっている可能性があります。GCPコンソールで確認してください。

直し方 — GCP コンソールで新しい鍵を作り、接続情報（Google Cloud Storage）を作り直してください。

鍵の JSON が壊れている

貼り付けた JSON の書式が崩れているときに出ます。

接続情報が不正です。サービスアカウントJSONのフォーマットに誤りがあります。GCPコンソールからダウンロードしたJSONの内容を正しく貼り付けているか確認してください。

直し方 — ダウンロードしたファイルを開き、中身をまるごと貼り直してください。

鍵の中の改行が崩れている

JSON の private_key の書き方が崩れているときに出ます。

接続情報が不正です。アクセスキー内のprivate_keyが「“」で囲まれているかなど、JSONの書式を確認してください。

直し方 — テキストエディタで整形せず、ダウンロードしたままの字を貼ってください。

1 件も見つからない

ファイルキーとサフィックスの両方に当てはまるファイルが 1 つもないときに出ます。

一致するファイルが見つかりませんでした。読み込むファイルの設定を確認してください。

直し方 — ファイルキーを短くして範囲を広げるか、サフィックスを空にして確かめてください。