CSV（カンマ区切り値）ファイルを提供する任意のソースから Looker レポートにデータを取り込むことができます。CSV ファイルはパソコンから直接アップロードできます。
CSV ファイルのデータソースを作成する
Looker レポートでは、アップロードされた CSV ファイルがデータセットに保存されます。データセットには、同じ列ヘッダーを持つ 1 つ以上の CSV ファイルを含めることができます。CSV ファイルのデータソースには、1 つ以上のデータセットを含めることができます。
新しい CSV ファイルのデータソースを作成する手順は次のとおりです。
- Looker レポートを開きます。
- [作成] ボタンをクリックし、[データソース] を選択します。
- CSV ファイルのアップロード Google コネクタを選択します。
- [データセットを追加] ボタンをクリックして、新しいデータセットを作成します。
- 1 つ以上の CSV ファイルを [使用可能なデータセット] セクションにドラッグすることもできます。Looker レポートでは、アップロードされたファイルを含む新しいデータセットが作成されます。
- ファイルのアップロードが完了したら、[接続] ボタンをクリックします。
アップロードしたデータは Cloud Storage に保存されます。このストレージ設定には、クラウドからデータにアクセスしてダウンロードできることや、他の Google Cloud サービスでデータを使用できることなど、多くのメリットがあります。
データセットに CSV ファイルを追加する
列ヘッダーが一致していれば、データセットに複数のファイルをアップロードできます。新しいファイルを追加すると、そのファイルのデータがデータセットの末尾に追加されます。これにより、時間の経過とともにデータを更新できます。
データセットに CSV ファイルを追加する手順は次のとおりです。
- Looker レポートを開きます。
- [データソース] タブをクリックします。
- CSV ファイルを含むデータソースを選択します。
- [接続を編集] をクリックします。
- [使用可能なデータセット] セクションで、ファイルの追加元となるデータセットを選択します。
- [ファイルを追加] ボタンをクリックします。
- 1 つ以上の CSV ファイルを [データセット内のファイル] セクションにドラッグすることもできます。
- ファイルのアップロードが完了したら、[再接続] ボタンをクリックします。
データセットを共有する
作成したデータセットは、作成したユーザーによって所有されるため、共有することはできません。ただし、データセットに基づいてデータソースを作成したら、そのデータソースを他のユーザーと共有できます。つまり、共有のデータソースやレポート内でデータセットを使用することはできますが、データセット自体にアクセスできるのは作成したユーザーに限られます。
アップロード ファイルの形式
アップロードするファイルの形式が正しいことを確認してください。正しくないと、アップロード中にエラーが発生したり、レポートでデータが正しく表示されなかったりする可能性があります。
コンテンツ エラーが発生する一般的な原因として、アップロードしたデータ内で区切り文字、引用符、改行文字が誤って使用されていることが考えられます。CSV ファイルのアップロードでこれらの処理方法を理解しておくと、今後問題が発生するのを防ぐことができます。
UTF-8 エンコード
アップロードするファイルのエンコードは UTF-8 にする必要があります。これは、ウェブ上のほとんどのアプリケーションで標準のエンコードです。
ただし、Microsoft Excel™ などの特定のデスクトップ プロダクトからデータをエクスポートする場合は、Looker
レポートにアップロードする前にファイルを UTF-8 に変換する必要があります。変換しないと、Looker レポートでFile is Invalid.などのエラー メッセージが返されることがあります。
表形式データのみ
CSV ファイルのアップロードでは、表形式のデータのファイルのみをインポートできます。つまり、ファイルは行と列の規則的な構造でなければなりません。テーブル内の特定のセルにデータがない場合でも、各行の列数は同じである必要があります。結合されたセルを含むファイルや、異なる構造を持つファイルをアップロードしようとすると、アップロード エラーが発生します。
区切り文字（セパレータ）
データに含まれるすべてのフィールドは、それぞれカンマで区切る必要があります。
アップロードするフィールドの実際のデータ内にカンマがある場合は、そのフィールドを引用符で囲む必要があります。データに二重引用符が含まれている場合は、単一引用符を使用してフィールドを囲むことができます。
ヘッダー行
ファイルの 1 行目は、見出し行にする必要があります。この行では、Looker レポートで使用するフィールドの名前を指定します。フィールド名は重複しないようにする必要があるため、見出し行で重複する値を指定することはできません。
列名は次の条件を満たす必要があります。
- 文字、数字、アンダースコアのみを含める。その他の句読点や特殊文字は使用できません。
- 文字またはアンダースコアで始まる
- 128 文字以下にする
見出し行も、区切り文字に関する規則に沿ったものにします。
改行
ファイルの各行は改行で終わる必要があります。CSV ファイルのアップロードでは、引用符でエスケープされている場合でも、データ内の改行はサポートされません。
トラブルシューティング
次のセクションでは、CSV ファイルのアップロード時に発生する一般的なエラーについて説明します。
エラー: ファイルが無効です
CSV ファイルをアップロードしようとした後に Looker で「File is Invalid」というエラーが表示された場合は、次の原因が考えられます。
- ファイルに無効な UTF-8 文字が含まれている。
- ファイルが実際には CSV ファイルではない。たとえば、PDF ファイルの名前を変更して拡張子を「.csv」にした場合、Looker レポートでファイルを正しく解析できません。
CSV ファイルのアップロードに関する制限事項
CSV ファイルのアップロードには、次の制限があります。
- データセットはユーザー 1 人あたり 1,000 個まで
- ユーザー 1 人あたりの合計ストレージ容量は 2 GB
- データセットごとに 1 日あたり 100 回のアップロード
- データセットあたりのファイルサイズの上限は 100 MB