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

このページでは、Looker からコンテンツ（ビジュアリゼーションまたはデータ）をダウンロードする方法について説明します。

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

コンテンツのダウンロードおよびダウンロード コンテンツのフォーマットのプロセスとオプションは、Look または Explore から、ダッシュボードから、以前のダッシュボードから、マージされた結果クエリからダウンロードするかどうかによって異なります。

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

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

[ダウンロード] ウィンドウが開きます。ここで、ダウンロードの名前と形式を設定できます。

以下のセクションでは、[Download] ウィンドウの各項目について説明します。

ファイル形式

レンダラを使用する形式（PNG と PDF）でダウンロードした場合、本番環境モードでの結果が使用されます。別の形式のファイルのダウンロードでは、開発モードと本番環境を問わず、いずれのモードでもダウンロード結果が表示されます。

データは、次の形式で Look と Explore からダウンロードできます。

  • TXT（タブ区切り値）
  • Excel スプレッドシート（Excel 2007 以降）
  • CSV
  • JSON
  • HTML
  • マークダウン
  • PNG（可視化の画像）

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

JSON 形式の場合、Looker は JSON 出力でフィールド labels をレンダリング値として使用します。Looker がフィールドを JSON 形式でレンダリングする方法の詳細については、JSON 形式の変更のコミュニティ トピックをご覧ください。

転置されたテーブルは、ダウンロードした PNG でのみ表示されます。

Looker 開発者が開発モードを使用している場合、ほとんどのファイル形式のデータのダウンロードでは、開発モードと同様にモデルに対してクエリが実行されます。ただし、PDF と PNG のファイル形式は例外です。これらのファイル形式でのデータのダウンロードでは、常にモデルが本番環境モードであるかのようにモデルが照会されます。

結果

[結果] で、データのダウンロードに可視化設定を適用するかどうかを選択します。

[データ表に表示される] を選択した場合、ビジュアリゼーションのオプションは適用されず、ダウンロードは Look または Explore の [データ] セクションのデータ表のように表示されます。

値

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

  • [Unformated] を選択した場合、Looker はクエリ結果の特別な書式設定（長い数値の丸め、Looker 開発者によって設定された特殊文字の追加など）を適用しません。これは多くの場合、処理のためにデータを他のツールに送信するときに推奨されます。
  • [フォーマット済み] を選択すると、データは Looker の [探索] エクスペリエンスとほぼ同じように表示されますが、一部のファイル形式（リンクなど）は一部のファイル形式ではサポートされません。

制限事項

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

  • 表内の結果: コンテンツの行数制限で指定された行数。
  • すべての結果: クエリによって返されたすべての結果。このオプションを選択する前に、このページの [すべての結果] をご覧ください。
  • カスタム: カスタムの行数。download_with_limit 権限を持つユーザーは 5,000 行に制限されます。他のユーザーの上限は、通常 Looker 管理者が上限を引き上げない限り、100,000 です（以前の機能: 無制限のダウンロードを許可する（Looker 4.14 以降）のコミュニティ トピックをご覧ください）。

すべての結果

Look または Explore で [Run] をクリックすると、Looker は権限を確認し、クエリの複雑さとデータベース言語によってクエリ全体をダウンロードできるかどうかを判断します。権限（設定した上限を超える結果）があり、Looker でクエリ全体をダウンロードできると判断された場合は、[Download] ウィンドウで [All Results] オプションを使用できます。

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

[すべての結果] オプションが使用可能であっても、すべての結果をダウンロードする際には注意が必要です。クエリの規模が非常に大きく、何千、何百万行もの行が含まれていると、ほとんどのスプレッドシート プログラムや Looker インスタンスでさえも圧倒される可能性があります。

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

ストリーミング クエリ結果

ストリーミングとは、一度にすべてではなく、チャンクでデータを処理する Looker の機能です。Lookerが結果セットをストリーミングできる場合、無制限の数のダウンロードが可能です。

Looker では、ダウンロードされた結果を、レンダリングされた形式（HTML、PNG）を除くすべての形式にストリーミングします。

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

  1. 表計算: 表計算はストリーミングできません。そのため、クエリ結果を無制限にダウンロードするには、クエリから表計算を削除することが必要です。
  2. データベースの制限: クエリにピボットが含まれていると、一部のデータベースがストリーミングできません。これらのデータベースでは、ピボットを削除して結果を無制限にダウンロードする必要があります。一部のデータベースでは結果をストリーミングできません。つまり、無制限にダウンロードすることはできません。以下は、ストリーミングをサポートするデータベースのリストと、ピボットが適用されたストリーミングをサポートするデータベースのリストです。

クエリからすべてのソートを削除する

[すべての結果] を選択した場合、[クエリからすべての並べ替えを削除] オプションが表示されることもあります。このオプションにより、結果をダウンロードする前にクエリの並べ替えが行われなくなります。このオプションを選択すると、データベース タイプによってはクエリを並べ替える際にコストが高くなるため、ダウンロードを高速化できます。

ピボット結果では [Remove all sort from query] オプションはサポートされていません。

大きな結果を許可する

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

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

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

ファイル名

ダウンロード用のファイル名を入力するか、フィールドにあらかじめ設定されたデフォルトのファイル名を使用します。Looker は、[File Format] フィールドでの選択に基づいて、適切なファイル拡張子を自動的に追加します。

ブラウザでダウンロードまたは開く

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

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

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

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

このセクションでは、新しいダッシュボードを使用するダッシュボードのダウンロードについて説明します。以前のダッシュボードのダウンロードについては、以前のダッシュボードからデータをダウンロードするをご覧ください。

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

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

ダッシュボードを PDF 形式でダウンロードする

ダッシュボード全体を PDF 形式でダウンロードできます。つまり、ダッシュボードのタイトル、すべてのダッシュボード フィルタ、すべてのダッシュボード タイル、ダッシュボードが実行されたタイムゾーンの PDF 画像が表示されます。PDFには、ダッシュボードのダウンロード時刻を示すタイムスタンプも含まれます。

ダッシュボードを PDF 形式でダウンロードすると、ダッシュボードの永続的な形式に応じて、新しいダッシュボードまたは以前のダッシュボードが PDF に表示されます。つまり、URL を変更したために別の形式でダッシュボードを一時的に表示した場合、そのダウンロードには永続的な形式が反映されます。

PDF 形式でダウンロードすると、開発モードになっている場合でも、モデルは常に本番環境モードでデータが返されます。

ダッシュボードを PDF 形式でダウンロードする手順は次のとおりです。

  1. [形式] プルダウン メニューから [PDF] を選択します。
  2. [用紙サイズ] プルダウン メニューからオプションを選択します。[Fit Page to Dashboard] オプションがデフォルトで選択されており、画面上のダッシュボードのレイアウトに合わせて PDF のサイズが変更されます。他の用紙サイズ オプションでは、標準的な用紙サイズに合わせて PDF のサイズを調整し、ダッシュボード内に収めることができます。ダッシュボードのレイアウトによっては、大きなビジュアリゼーションや重複するタイルのグループを、ページサイズに合わせてサイズ変更する必要があります。



    [用紙サイズ] オプションが表示されない場合は、Looker インスタンスに最新バージョンの Chromium レンダラをインストールする方法について Looker の管理者にお問い合わせください。
  3. [Paper Size] プルダウンから [Fit Page to Dashboard] 以外を選択すると、[Orientation] オプションが表示されます。ダッシュボードの向きとして縦または横を選択できます。
  4. [表を展開してすべての行を表示] を選択またはオフのままにします。このオプションを選択した場合、表ビジュアリゼーションを使用するダッシュボード タイルの場合、ダッシュボード タイルのサムネイルに表示される行だけでなく、テーブルのビジュアリゼーションで使用可能なすべての行が PDF に表示されます。このオプションを選択しないと、スクロールなしでサムネイルに表示される行のみが PDF に表示されます。ダッシュボードとクエリのフィルタは引き続き適用されます。また、行数制限、列の上限、表示される行の上限オプションなどの設定も適用されます。 [表を展開してすべての行を表示] オプションが表示されない場合は、Looker インスタンスに適切なバージョンの Chromium レンダラをインストールする方法について Looker の管理者にお問い合わせください。
  5. [ダッシュボードのタイルを 1 つの列に整理] を選択またはオフのままにします。このオプションを選択すると、PDF のダッシュボード タイルが縦一列に並んで表示されます。このオプションを選択しない場合、ダッシュボードタイルはダッシュボード上の配置どおりに表示されます。
  6. [ブラウザで開く] をクリックすると、ブラウザの新しいタブで PDF の画像が表示されます。ここで、ブラウザのコントロールを使用して PDF をダウンロードできるようになります。
  7. ダッシュボードをダウンロードする必要がなくなった場合は、[キャンセル] をクリックします。
  8. [ダウンロード] をクリックしてダウンロードを開始します。ブラウザで新しいタブが開き、ダウンロードの状況が表示されます。

Looker 管理者が [Render Long Tables] Labs 機能を有効にして、[Expand Tables to Show All Rows] オプションをオンにしている場合、テーブルのビジュアリゼーションを含むタイルは、ダウンロードした PDF と Looker では多少異なる場合があります。違いについて詳しくは、ラボのドキュメントをご覧ください。

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

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

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

ダッシュボードを CSV ファイルとしてダウンロードすると、カスタムの行制限の設定やすべての結果の選択など、ダウンロード形式を選択することはできません。ダウンロードされたファイルの行の制限は、対応するタイルの行の上限と相関関係があります。

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

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

Merged Results クエリに基づいてダッシュボード タイルからデータをダウンロードすることはできませんが、マージされた結果タイルのデータは、ダッシュボードを PDF 形式でダウンロードしたり、CSV ファイルの集合としてダウンロードしたりできます。

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

ダイアログ ボックスが開き、Look または Explore のオプションおよび以前のダッシュボード タイルのダウンロードに類似したいくつかのオプションが表示されます。[詳細データ オプション] メニューを展開して、ダウンロードできるすべてのオプションを表示します。

フォーマット

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

  • TXT（タブ区切り値）
  • Excel スプレッドシート（Excel 2007 以降）
  • CSV
  • JSON
  • HTML
  • マークダウン
  • PNG（可視化の画像）

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

HTML または PNG（ビジュアリゼーションの画像）オプションがない場合は、Looker 管理者にお問い合わせのうえ、Looker インスタンスに適したバージョンの Chromium レンダラをインストールしてください。

JSON 形式の場合、Looker は JSON 出力でフィールド labels をレンダリング値として使用します。Looker がフィールドを JSON 形式でレンダリングする方法の詳細については、JSON 形式の変更のコミュニティ トピックをご覧ください。

表形式のビジュアリゼーションは、PDF と PNG のダウンロードでのみレンダリングされます。

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

結果

[結果] で、データのダウンロードに可視化設定を適用するかどうかを選択します。

[データ表に表示される] を選択した場合、ビジュアリゼーションのオプションは適用されず、ダウンロードは Look または Explore の [データ] セクションのデータ表のように表示されます。

データ値

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

  • [書式設定済み] を選択すると、そのデータは Looker の [Explore] によく似たものになりますが、一部の機能（リンクなど）はすべてのファイル形式でサポートされているわけではありません。
  • [Unformatted] を選択した場合、Looker は特殊な形式の結果（丸め処理による数値の丸め、Looker 開発者によって付けられた特殊文字の追加など）を適用しません。これは多くの場合、処理のためにデータを他のツールに送信するときに推奨されます。

含める行と列の数

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

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

Looker はユーザーの権限を確認し、クエリの複雑さとデータベース言語によってクエリ全体をダウンロード可能かどうかを判断します。設定された上限を超えて結果をダウンロードする権限があり、Looker でクエリ全体をダウンロードできると判断された場合は、[Download] ウィンドウで [All Results] オプションを使用できます。

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

[すべての結果] オプションが使用可能であっても、すべての結果をダウンロードする際には注意が必要です。クエリの規模が非常に大きく、何千、何百万行もの行が含まれていると、ほとんどのスプレッドシート プログラムや Looker インスタンスでさえも圧倒される可能性があります。

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

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

このセクションでは、以前のダッシュボードについて説明します。新しいダッシュボードを使用してダッシュボードをダウンロードする方法については、ダッシュボードからデータをダウンロードするをご覧ください。

Looker では、以前のダッシュボードをダウンロードして、最新のデータを保存または共有できます。以前のダッシュボードは、PDF 形式で、または CSV ファイルの zip 形式でダウンロードできます。

以前のダッシュボードを PDF 形式でダウンロードする

以前のダッシュボードを PDF 形式でダウンロードするには:

  1. ページの右上にある歯車アイコンをクリックします。

  2. [PDF 形式でダウンロード] を選択します。

    [ダウンロード] ウィンドウが開きます。ここで、ダウンロードの名前と形式を設定できます。

  3. 必要に応じて、[ファイル名] ボックスを使用して PDF ファイルの名前を変更します。

  4. 必要に応じて [詳細オプション] メニューを展開し、PDF をさらにカスタマイズします。

    以前のダッシュボード タイルを縦一列に表示する場合は、[単一列の形式] チェックボックスをオンにします。タイルを以前のダッシュボードに配置したときにタイルを PDF に表示する場合は、このチェックボックスをオフのままにします。

    [表を展開してすべての行を表示] オプションを選択した場合、表形式のビジュアリゼーションを使用するダッシュボード タイルの場合は、ダッシュボード タイルのサムネイルに表示される行だけでなく、表ビジュアリゼーションで使用可能なすべての行が PDF に表示されます。このオプションを選択しないと、スクロールなしでサムネイルに表示される行のみが PDF に表示されます。ダッシュボードとクエリのフィルタは引き続き適用されます。また、行の上限、列の上限、表示される行の上限オプションなどの設定も適用されます。

    [用紙サイズ] プルダウン メニューから PDF の最適なサイズと向きを指定することもできます。場合によっては、大きなビジュアリゼーションや重なっているダッシュボードタイルのグループは、PDFのページにきれいに収まるようにサイズを変更する必要があります。

    [Paper size] または [Expand tables to show all rows] のオプションが表示されない場合は、Looker インスタンスに適切なバージョンの Chromium レンダラをインストールする方法について、Looker 管理者にお問い合わせください。

  5. [ダウンロード] または [ブラウザで開く] をクリックします。

PDF 形式でダウンロードすると、開発モードになっている場合でも、モデルは常に本番環境モードでデータが返されます。

ダッシュボードを PDF としてダウンロードすると、永続的な形式に応じて、ダッシュボードの新しいダッシュボードまたは従来のダッシュボードが表示されます。つまり、URL を変更したために別の形式でダッシュボードを一時的に表示した場合、そのダウンロードには永続的な形式が反映されます。

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

以前のダッシュボードから CSV ファイルをダウンロードするには、ダッシュボードの右上にある歯車アイコンをクリックして [CSV 形式でダウンロード] を選択し、ダウンロードを開始します。

圧縮されたディレクトリには、ダッシュボード タイルごとに個別の CSV ファイルが含まれます。各CSVファイルには、ダッシュボードのタイルを作成するための書式設定済みデータが含まれています。

ダッシュボードを CSV ファイルとしてダウンロードする場合、カスタムの行制限の設定や [すべての結果] の選択など、ダウンロードの書式設定オプションは使用できません。ダウンロードされたファイルの行の制限は、対応するタイルの行の上限と相関関係があります。

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

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

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

タイルのダウンロード ウィンドウとオプションは、Look や Explore の場合と似ています。データのダウンロードをカスタマイズするためのオプションについて詳しくは、Look または Explore からデータをダウンロードするをご覧ください。すべての結果をダウンロードした場合、Look や Explore の場合と同じようにクエリから並べ替えを削除するためのオプションが表示されません。

Merged Results クエリに基づいて以前のダッシュボード タイルからデータをダウンロードすることはできませんが、以前のダッシュボードを PDF 形式でダウンロードする場合、または CSV ファイルの集まりとしてダウンロードする場合は、マージされた結果タイルからのデータが含まれます。

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

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

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

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

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