コンテンツのダウンロード

このページでは、Looker からコンテンツ(可視化またはデータ)をダウンロードする方法について説明します。

コンテンツをダウンロードするには、Looker 管理者から download_with_limit または download_without_limit の権限を付与されている必要があります。

コンテンツのダウンロードおよびダウンロードしたコンテンツのフォーマットに関するプロセスおよびオプションは、Look または Exploreダッシュボード、または結合結果クエリのいずれからダウンロードするかに応じて異なります。

Look または Explore からデータをダウンロードする

Look または Explore ページからデータをダウンロードするには、右上の歯車メニューを選択して [ダウンロード] を選択します。

Looker に [ダウンロード] ウィンドウが表示され、ダウンロードの名前と形式を設定できます。

以降のセクションでは、[ダウンロード] ウィンドウの各フィールドについて説明します。

形式

レンダラを使用する形式(PNG と PDF)でダウンロードすると、本番環境モードの結果が使用されます。別の形式でダウンロードする場合は、使用している(開発モードまたは本番環境モード)モードの結果が表示されます。

Look と Explore から次のファイル形式でデータをダウンロードできます。

  • TXT(タブ区切り値)
  • Excel スプレッドシート(Excel 2007以降)
  • CSV
  • JSON
  • HTML
  • マークダウン
  • PNG(表示画像)

ダウンロードするデータ形式を選択する際に、Look 用の HTML または PNG(表示画像)オプションが表示されない場合は、Looker 管理者に問い合わせて、Looker インスタンス用の Chromium レンダラの適切なバージョンをインストールする方法をご確認ください。

JSON 形式の場合、Looker では、JSON 出力でレンダリングされた値としてフィールドラベルを使用します。Looker で JSON 形式でフィールドがどのようにレンダリングされるかについては、JSON 形式の変更のコミュニティ投稿をご覧ください。

行 / 列の入れ替えられたテーブルでは、PNG ダウンロードでのみレンダリングされます。

Looker デベロッパーが Development Mode を使用している場合、ほとんどのファイル形式のデータのダウンロードでは、Development Mode の場合と同様にモデルがクエリされます。PDF と PNG のファイル形式は例外です。これらのファイル形式でのデータのダウンロードでは、常に本番環境モードの場合と同様にモデルをクエリします。

ファイル名

ダウンロード用のファイル名を入力するか、フィールドに事前入力されたデフォルトのファイル名を使用できます。Looker では、[形式] フィールドでの選択に基づいて、適切なファイル拡張子が自動的に追加されます。

結果

[結果] セクションで、可視化設定を TXT、Excel、CSV、JSON、HTML、マークダウンのデータのダウンロードに適用するかどうかを選択します。

[表示オプションの適用] を選択すると、表示設定の一部が適用されます。表示用に構成された [プロット]、[シリーズ]、[書式設定] メニューの次のいずれかの設定は、データのダウンロードに適用されます。

スケーリング ルールを適用が適用されている場合にのみ、テーブルグラフが可視化された条件付き書式が Look と Explore の Excel デリバリーで表示されます。

一部の可視化設定は、ダウンロードした結果には適用されません。例:

  • カスタム ヘッダーのテキスト色と背景色は、PNG ファイルを除き、ダウンロードした結果には適用されません。
  • ピボットと複数の measure がある結果テーブルの場合、各ピボット値は 1 つの結合列として表されるのではなく、列間で繰り返されます。HTML と PNG のダウンロードは例外で、結合された列は保持されます。
  • ダッシュボードからダウンロードする場合、ダッシュボードタイルのタイトルはダウンロードした結果に含まれません。
  • [合計] と [行の合計] の値はダウンロードされた結果に含まれますが、それぞれの行と列にはラベルは付けられません。
  • ストリーミングできないクエリについては、小計はダウンロードされません。

クエリに次のいずれかの要素が含まれている場合、手動で並べ替えられたテーブルグラフの列は、ダウンロードされた元の順序で表示されます。

[データテーブルに表示] を選択すると、可視化オプションは適用されず、Look または Explore の [Data] セクションにデータテーブルが表示されます。

データ値

[データ値] セクションで、ダウンロードしたクエリ結果の表示方法を選択します。

  • [Unformated] を選択した場合、Looker では、Looker デベロッパーが配置した長すぎる番号の丸めや特殊文字の追加など、特別な形式のクエリ結果を適用しません。これは多くの場合、処理のためにデータを他のツールにフィードするときに推奨されます。
  • [書式設定済み] を選択すると、データの外観は Looker の [Explore] エクスペリエンスに似ていますが、一部のファイル形式(リンクなど)ではすべてのファイル形式でサポートされるわけではありません。たとえば、html パラメータで適用された書式設定は、TXT、CSV、Excel、JSON ダウンロードには適用されません。

含める行と列の数

次のように、ダウンロードするデータの量を選択できます。

  • 現在の結果テーブル: コンテンツの行数制限で指定された行数。
  • すべての結果: クエリによって返されるすべての結果。このオプションを選択する前に、このページの [すべての結果] セクションをご覧ください。
  • カスタム: 行のカスタム数。download_with_limit 権限を持つユーザーは、5,000 行に制限されています。その他のユーザーの上限は、通常 100,000 です。

すべての結果

Look または Explore で [実行] を選択すると、Looker が権限をチェックし、クエリの複雑さとデータベース言語によってクエリ全体をダウンロードできるかどうかが判定されます。権限があり(設定した制限を超える結果の場合)、クエリ全体をダウンロードできると Looker が判断した場合、[ダウンロード] ウィンドウで [すべての結果] オプションを利用できます。

通常、[すべての結果] オプションは、次のいずれかを行うクエリでは無効になります。

[すべての結果] オプションを使用できる場合でも、すべての結果をダウンロードする際は注意が必要です。クエリの中には、数千行から数百万行を含む非常に大規模なクエリがあり、ほとんどのスプレッドシート プログラム(さらには Looker インスタンス)を圧迫するおそれがあります。

[すべての結果] オプションが使用できない場合は、[カスタム] オプションを使用して、権限で許可される最大行数を指定できます。

クエリ結果をストリーミングする

ストリーミングとは、データを一度にすべてではなくチャンクとして処理するLookerの機能のことです。Lookerが結果セットをストリーミングできる場合、無制限の数のダウンロードが可能です。 [すべての結果] オプションは、Looker の結果をストリーミングする機能に依存しており、結果をストリーミングできない場合、[すべての結果] は使用できません。

書式設定制限に加え、ストリーミングが不可能な次の2つのケースがあります。

  1. 表計算: 表計算はストリーミングできません。そのため、クエリ結果を無制限にダウンロードするには、クエリから表計算を削除することが必要です。
  2. データベースの制限: 一部のデータベースは、クエリにピボットが含まれているとストリーミングできません。そうしたデータベースの場合、結果を無制限にダウンロードするにはピボットを削除しなければなりません。いずれの結果もストリーミングできないデータベースもあります。その場合は、無制限のダウンロードも行えません。

次のデータベースはストリーミングをサポートしています。

方言 サポート対象
Actian Avalanche
はい
Amazon Athena
はい
Amazon Aurora MySQL
はい
Amazon Redshift
はい
Apache Druid
いいえ
Apache Druid 0.13+
いいえ
Apache Druid 0.18+
いいえ
Apache Hive 2.3+
はい
Apache Hive 3.1.2+
はい
Apache Spark 3 以降
はい
ClickHouse
はい
Cloudera Impala 3.1+
はい
ネイティブ ドライバを使用した Cloudera Impala 3.1+
はい
ネイティブ ドライバを使用した Cloudera Impala
はい
DataVirtuality
はい
Databricks
はい
Denodo 7
はい
Denodo 8
はい
Dremio
はい
Dremio 11+
はい
Exasol
はい
Firebolt
はい
Google BigQuery Legacy SQL
はい
Google BigQuery Standard SQL
はい
Google Cloud PostgreSQL
はい
Google Cloud SQL
Google Spanner
×
Greenplum
はい
HyperSQL
いいえ
IBM Netezza
いいえ
MariaDB
はい
Microsoft Azure PostgreSQL
はい
Microsoft Azure SQL Database
はい
Microsoft Azure Synapse Analytics
はい
Microsoft SQL Server 2008+
はい
Microsoft SQL Server 2012+
はい
Microsoft SQL Server 2016
はい
Microsoft SQL Server 2017+
はい
MongoBI
はい
MySQL
はい
MySQL 8.0.12+
はい
Oracle
はい
Oracle ADWC
はい
PostgreSQL 9.5+
はい
PostgreSQL 9.5 より前
はい
PrestoDB
はい
Presto SQL
はい
SAP HANA 2+
いいえ
SingleStore
はい
SingleStore 7+
はい
Snowflake
はい
Teradata
はい
Trino
はい
Vector
はい
Vertica

ピボットが適用されたストリーミングをサポートするデータベースは次のとおりです。

方言 サポート対象
Actian Avalanche
はい
Amazon Athena
はい
Amazon Aurora MySQL
いいえ
Amazon Redshift
はい
Apache Druid
いいえ
Apache Druid 0.13+
いいえ
Apache Druid 0.18+
いいえ
Apache Hive 2.3+
いいえ
Apache Hive 3.1.2+
いいえ
Apache Spark 3 以降
はい
ClickHouse
いいえ
Cloudera Impala 3.1+
はい
ネイティブ ドライバを使用した Cloudera Impala 3.1+
はい
ネイティブ ドライバを使用した Cloudera Impala
はい
DataVirtuality
いいえ
Databricks
はい
Denodo 7
いいえ
Denodo 8
いいえ
Dremio
いいえ
Dremio 11+
いいえ
Exasol
はい
Firebolt
はい
Google BigQuery Legacy SQL
はい
Google BigQuery Standard SQL
はい
Google Cloud PostgreSQL
はい
Google Cloud SQL
×
Google Spanner
×
Greenplum
はい
HyperSQL
いいえ
IBM Netezza
はい
MariaDB
いいえ
Microsoft Azure PostgreSQL
はい
Microsoft Azure SQL Database
はい
Microsoft Azure Synapse Analytics
はい
Microsoft SQL Server 2008+
はい
Microsoft SQL Server 2012+
はい
Microsoft SQL Server 2016
はい
Microsoft SQL Server 2017+
はい
MongoBI
いいえ
MySQL
いいえ
MySQL 8.0.12+
いいえ
Oracle
はい
Oracle ADWC
はい
PostgreSQL 9.5+
はい
PostgreSQL 9.5 より前
はい
PrestoDB
はい
Presto SQL
はい
SAP HANA 2+
いいえ
SingleStore
はい
SingleStore 7+
はい
Snowflake
はい
Teradata
はい
Trino
はい
Vector
はい
Vertica

クエリからすべての並べ替えを削除

[すべての結果] を選択すると、[クエリからすべての並べ替えを削除] のオプションが表示されることもあります。このオプションにより、結果をダウンロードする前にクエリを並べ替えることを回避できます。このオプションを選択すると、特定のデータベース タイプではクエリを並べ替えるとパフォーマンスが低下する可能性があるため、ダウンロードが高速化される可能性があります。

[クエリからすべての並べ替えを削除] オプションは、ピボットされた結果ではサポートされていません。

大容量の結果の許可

データベース言語として Google BigQuery を使用して Looker で大規模な結果セットをダウンロードするときに [すべての結果] を選択すると、大規模な結果の許可 オプションが表示されます。これは、Google Cloud ドキュメントのトピックのクエリ結果の書き込みで説明されているように、Google BigQuery がクエリ結果の最大レスポンス サイズを持っているためです。BigQuery の最大レスポンス サイズを超える結果をダウンロードするには、Looker が別のプロセスを実行する必要があります。

[大容量の結果の許可] を選択した場合、ダウンロード プロセスは次のように影響を受けます。

  • クエリの allowLargeResults BigQuery オプションは true に設定されます。
  • クエリの ORDER BY 句が削除されます。
  • クエリは PDT 一時スキーマに書き込まれます。このスキーマに書き込む権限が必要です。
  • クエリの結果は、この一時的なスクラッチ スキーマにランダムなテーブル名で 1 時間保存されます。

ブラウザでダウンロードするか開く

オプションを選択したら、[ダウンロード] ボタンをクリックしてコンピュータにファイルをダウンロードするか、[ブラウザで開く] を選択してブラウザでファイルを表示します。

マージされた結果クエリからのデータのダウンロード

統合結果クエリをダウンロードするには、クエリをダッシュボードに保存してから、ダッシュボードを PDF または CSV ファイルのコレクションとしてダウンロードします。ただし、ダッシュボード全体をダウンロードする必要があります。統合された結果のクエリに基づく 1 つのタイルのみからデータをダウンロードすることはできません。

ダッシュボードからデータをダウンロードする

ダッシュボード全体をダウンロードするには、ダッシュボードのその他メニューから [ダウンロード] を選択します。

ダイアログ ボックスが開き、ダウンロード形式として PDF または CSV を選択できます。

ダッシュボードを PDF としてダウンロードする

ダッシュボード全体を PDF としてダウンロードできます。この場合、ダッシュボードのタイトル、ダッシュボードフィルタ、一部またはすべてのダッシュボードタイル、ダッシュボードが実行されているタイムゾーンが含まれている PDF を取得することになります。PDF には、ダッシュボードがダウンロードされた時点を示すタイムスタンプも含まれます。

PDF 形式でのダウンロードでは、Development Mode にあっても、常に本番環境モードのモデルからデータが返されます。

ダッシュボードをPDFとしてダウンロードするには、以下のステップを実行します。

  1. [形式] プルダウン メニューから [PDF] を選択します。
  2. [用紙サイズ] プルダウン メニューからオプションを選択します。

    デフォルトでは、[ページをダッシュボードに合わせる] オプションが選択されています。PDF は、ダッシュボードのデフォルトの幅(1260 px)に変更されます。その他の用紙サイズオプションでは、標準の用紙サイズに合わせて、ダッシュボードの全体または一部に収まるように、PDF のサイズが設定されます。ダッシュボードのレイアウトや選択した用紙サイズによっては、一部の PDF 出力が Looker で表示する際のダッシュボードのレイアウトと異なる場合があります。たとえば、選択した用紙サイズがダッシュボードよりも小さい場合は、間隔やその他の書式設定に問題があり、いくつかの調整が必要になることがあります。

    • 大きなビジュアリゼーションや重なっているタイルのグループの場合、PDF に合わせてサイズの変更が必要になる場合があります。
    • テーブルを含むタイルでは、PDF にすべてのテーブル列が表示されない場合があります。
    • タイルは、PDF に合わせて幅が縮小される場合があります。同様に、Looker アプリでスクロールが必要なタイルは、すべてのコンテンツを表示するために展開されない場合があります。

    [用紙サイズ] が表示されない場合は、Looker インスタンスに適した最新バージョンの Chromium レンダラのインストールについて Looker 管理者にお問い合わせください。

  3. [用紙サイズ] プルダウンで [ページをダッシュボードに合わせる] 以外を選択すると、[画面の向き] オプションが表示されます。ダッシュボードの向きとして縦または横を選択できます。

  4. [テーブルを開いてすべての行を表示] を選択または選択解除します。このオプションを選択すると、テーブル表示を使用するダッシュボード タイルの場合、PDF には、ダッシュボード タイルのサムネイルに表示される行だけでなく、テーブル表示で使用できるすべての行が表示されます。このオプションを選択しない場合は、スクロールせずにサムネイルに表示される行だけが PDF に表示されます。ダッシュボードとクエリフィルタは引き続き適用され、行の制限列の制限などの表示の設定、および表示される行の上限 オプションによる設定も適用されます。

    [表を展開してすべての行を表示する] オプションを選択すると、テーブルが可視化されているダッシュボード タイルは、Looker 内での表示とは若干異なる状態でダウンロードされた PDF に表示される場合があります。PDF には次のような違いが見られる場合があります。

    • 列見出しと小計行から、背景色とフォントサイズのカスタマイズが削除されます。
    • カスタムテーマが設定されていない場合、テーブルは白いテーマに表示されます。それ以外の場合は、ダウンロード時にカスタムテーマが適用されます。
    • 手動で並べ替えられていないピボット テーブルには、並べ替えアイコンは表示されません。
    • [列が収まるようにサイズを変更] が有効になっているテーブルは、タイルの全幅にストレッチされます。

    また、セル数が 20,000 を超えるテーブルについては、PDF に次の違いが見られることがあります。

    [テーブルを開いてすべての行を表示] オプションが表示されない場合は、Looker インスタンスに適した Chromium レンダラのバージョンのインストールについて Looker 管理者にご相談ください。

  5. [ダッシュボード タイルを単一の列に配置する] を選択またはオフのままにします。このオプションを選択すると、PDFでダッシュボードタイルが単一の垂直列に表示されます。このオプションを選択しない場合、ダッシュボードタイルはダッシュボード上の配置どおりに表示されます。

  6. [ブラウザで開く] を選択すると、ブラウザの新しいタブに PDF の画像が表示されます。ここからブラウザのコントロールを使って PDF をダウンロードできます。

  7. ダッシュボードをダウンロードする必要がなくなった場合は、[キャンセル] を選択します。

  8. [ダウンロード] を選択してダウンロードを開始します。ブラウザで新しいタブが開き、ダウンロードのステータスが表示されます。

ダッシュボードを CSV としてダウンロードする

ダッシュボードのすべてのクエリタイルは、zipされたCSVファイルのコレクションとしてダウンロードできます。このzipファイルにはテキストタイルは含まれません。ダッシュボードをCSVファイルのコレクションとしてダウンロードするには、以下の手順に従ってください。

  1. [形式] プルダウン メニューから [CSV] を選択します。
  2. ダッシュボードをダウンロードする必要がなくなった場合は、[キャンセル] を選択します。
  3. [ダウンロード] をクリックして、圧縮された CSV コレクションのダウンロードを開始します。

ダッシュボードを CSV ファイルとしてダウンロードすると、カスタム行制限の設定やすべての結果の選択などのダウンロードのフォーマット オプションは使用できません。ダウンロードしたファイルの行制限は、対応するタイルの行制限と相関しています。

LookerではUTF-8エンコードを使ってzipファイルを生成します。CSV ファイル名の文字が文字化けしている場合は、Looker の UTF-8 エンコーディングとマシンのオペレーティング システムまたはサードパーティ アプリケーションのデフォルトのエンコーディングが競合している可能性があります。Looker では、UTF-8 を認識するファイル エクストラクタ(7-Zip など)を使用することと、サードパーティ アプリケーションが UTF-8 をサポートするように構成されていることを確認することをおすすめします。

ダッシュボードタイルからデータをダウンロードする

統合された結果のクエリに基づいて、ダッシュボード タイルからデータをダウンロードすることはできませんが、ダッシュボードを PDF としてダウンロードした場合、またはCSV ファイルのコレクションした場合、統合された結果のタイルのデータが含まれます。

ダッシュボード タイルからデータをダウンロードするには、タイルのその他アイコンを選択し、[データのダウンロード] を選択します。

ダイアログ ボックスが開き、Look または Explore のオプションに似た複数のオプションが表示されます。[データの詳細オプション] メニューを開くと、ダウンロードに使用できるすべてのオプションが表示されます。

フォーマット

データは、ダッシュボードタイルから次の形式でダウンロードできます。

  • TXT(タブ区切り値)
  • Excel スプレッドシート(Excel 2007以降)
  • CSV
  • JSON
  • HTML
  • マークダウン
  • PNG(表示画像)

選択した形式によっては、[データの詳細オプション] メニューの一部のオプションを使用できない場合があります。

HTML または PNG(表示画像)オプションがない場合は、Looker 管理者に連絡して、Looker インスタンスに適切なバージョンの Chromium レンダラをインストールします。

JSON 形式の場合、Looker では、JSON 出力でレンダリングされた値としてフィールドラベルを使用します。Looker で JSON 形式でフィールドがどのようにレンダリングされるかについては、JSON 形式の変更のコミュニティ投稿をご覧ください。

行 / 列が入れ替えられたテーブルの可視化は、PDF および PNG ダウンロードでのみレンダリングされます。

PNG 形式でのダウンロードでは、Development Mode にあっても、常に本番環境モードのモデルからデータが返されます。

結果

[結果] セクションで、データのダウンロードに表示設定を適用するかどうかを選択します。

[データテーブルに表示] を選択すると、表示オプションは適用されず、Look または Explore の [Data] セクションにデータテーブルが表示されます。

データ値

[データ値] セクションで、ダウンロードした結果の表示方法を選択します。

  • [Formatted] を選択すると、データは Looker の [Explore] エクスペリエンスに類似して表示されますが、一部の機能(リンクなど)はすべてのファイル形式でサポートされません。
  • [Unformated] を選択した場合、Looker では、Looker デベロッパーが配置した長すぎる番号の丸めや特殊文字の追加など、特別な形式のクエリ結果を適用しません。これは多くの場合、処理のためにデータを他のツールに送信するときに推奨されます。

含める行と列の数

このセクションでは、ダウンロードに含めるデータの量を指定できます。ほとんどのタイルで、ダウンロード ポップアップのこのセクションには [含める行数] という名前が付いています。タイルクエリにピボットされた項目が含まれている場合、このセクションには [含める行と列の数] と表示されます。オプションには、

すべての結果またはカスタム オプションを使用する場合の考慮事項

Looker が権限をチェックし、クエリの複雑さとデータベース言語によってクエリ全体をダウンロードできるかどうかが判定されます。設定した制限を超える結果をダウンロードする権限があり、クエリ全体をダウンロードできると Looker が判断した場合、[ダウンロード] ウィンドウで [すべての結果] オプションを利用できます。

通常、[すべての結果] オプションは、次のクエリでは無効になります。

[すべての結果] オプションを使用できる場合でも、すべての結果をダウンロードする際は注意が必要です。クエリの中には、数千行から数百万行を含む非常に大規模なクエリがあり、ほとんどのスプレッドシート プログラム(さらには Looker インスタンス)を圧迫するおそれがあります。

[すべての結果] オプションが使用できない場合は、[カスタム] オプションを使用して、権限で許可される最大行数を指定できます。[カスタム] を選択すると、ダウンロードする結果の行数を指定できます。クエリにピボット ディメンションが含まれている場合は、ダウンロードする列数を指定することもできます。

管理者向け: Looker インスタンスのデータのダウンロードを有効にする

特定のダウンロード オプションを使用するには、セルフホスト型の Looker デプロイの管理者が適切なバージョンの Chromium レンダラをインストールしている必要があります。インスタンスがLookerでホストされている場合は、Chromiumがすでにインストールされています。

ビジネス ユーザー機能の管理のドキュメント ページには、ダウンロード プロセスに関する重要な管理者用情報が記載されています。

ユーザーがダウンロードするために割り当てる必要がある権限、特に download_with_limit 権限と download_without_limit 権限について詳しくは、ロールのドキュメント ページをご覧ください。

多数の行があるテーブルの可視化を含むダッシュボードの PDF ダウンロードのレンダリング時間を短縮するために、Looker 管理者は [Render Long Tables] Labs 機能を有効にできます。