本頁說明如何從 Looker 下載內容 (包括視覺化或資料)。
如要下載內容，Looker 管理員必須授予您 download_with_limit 或 download_without_limit 權限。
下載內容的程序和選項，以及下載內容的格式，會因下載來源而異，包括從 Look 或「探索」頁面、從資訊主頁，或是從合併結果查詢下載。
從 Look 或「探索」下載資料
如要從 Look 或「探索」頁面下載資料，請選取右上方的齒輪選單，然後選取「下載」。
Looker 會顯示「下載」視窗，您可以在其中命名及設定下載格式。
以下各節將逐步說明「下載」視窗中的每個欄位：
格式
下載使用轉譯器的格式 (PNG 和 PDF) 時，系統會使用正式環境模式的結果。如果下載內容採用其他格式，系統會根據您目前使用的模式 (開發或正式版) 顯示結果。
您可以從 Look 和探索中下載下列格式的資料：
- TXT (定位點分隔值)
- Excel 試算表 (Excel 2007 以上版本)
- CSV
- JSON
- HTML
- Markdown
- PNG (圖表圖片)
選擇下載資料格式時，如果沒有看到 HTML 或 PNG (視覺化圖片) 選項 (適用於 Look)，請與 Looker 管理員聯絡，為 Looker 執行個體安裝適當版本的 Chromium 轉譯器。
如果是 JSON 格式，Looker 會使用欄位標籤做為 JSON 輸出內容的顯示值。如要進一步瞭解 Looker 如何以 JSON 格式算繪欄位，請參閱「JSON 格式變更」社群貼文。
轉置表格只會以 PNG 格式下載。
Looker 開發人員如果處於開發模式，以大多數檔案格式下載資料時，系統會查詢開發模式下的模型。但 PDF 和 PNG 檔案格式是例外狀況，以這些格式下載資料時，系統一律會查詢模型，就像模型處於「正式版模式」一樣。
檔案名稱
您可以輸入下載檔案的名稱，或使用欄位中預先填入的預設檔案名稱。Looker 會根據您在「格式」欄位中的選取項目，自動附加適當的副檔名。
結果
在「結果」部分，選擇是否要將視覺化設定套用至 TXT、Excel、CSV、JSON、HTML 或 Markdown 資料下載。
如果選擇「已套用圖表選項」，Looker 會將部分圖表設定套用至下載內容。在「繪圖」、「系列」和「格式」選單中，為資料下載套用視覺化設定：
- 顯示資料列數
- 顯示總計
- 顯示資料列總計
- 限制顯示的資料列，最多顯示或隱藏 500 列
- 顯示完整欄位名稱
- 每個資料欄的自訂標籤 (Looker 會使用欄位標籤做為 JSON 輸出中的顯示值。如要進一步瞭解 Looker 如何以 JSON 格式算繪欄位，請參閱「Change in JSON formatting」Looker 社群貼文。
- 條件式格式設定：以 Excel 格式下載表格圖表視覺化資料
只有在套用「沿著比例尺」規則時，Excel 傳送的 Look 和探索內容才會顯示條件式格式設定，且僅限表格圖表。
部分視覺化設定不會套用至下載的結果。例如：
- 下載結果時不會套用自訂標題文字顏色和背景顏色，但 PNG 檔案除外。
- 如果結果表格包含樞紐和多個指標，每個樞紐值都會在各個資料欄中重複顯示，而不是以一個合併的資料欄呈現。但 HTML 和 PNG 檔案除外，因此系統會保留合併的資料欄。
- 從資訊主頁下載時，下載結果不會包含資訊主頁動態磚標題。
- 下載的結果會包含「總計」和「列總計」值，但不會標示對應的列和欄。
- 如果查詢無法串流，系統就不會下載小計。
如果查詢包含下列任一元素，手動重新排列的表格圖表資料欄在下載時，會以原始順序顯示：
- 刻意從圖表隱藏的欄位
基礎 SQL 中存在但視覺化中不存在的欄位，例如：
- 視覺化呈現中的維度含有
link參數，但該參數參照的另一個欄位並未出現在視覺化呈現中。 - 使用
case參數的欄位。 - 視覺化效果中存在一個維度，該維度參照另一個含有
{{ field_name._value }} Liquid variable syntax的欄位，但該欄位並未出現在視覺化效果中。
- 視覺化呈現中的維度含有
啟用維度填入功能的一或多個欄位
三個以上的樞紐分析欄位
一或多個欄位，其中包含欄位定義中的
order_by_fieldLookML 參數
如果選擇「如資料表中所示」，系統不會套用圖表選項，下載內容的呈現方式會如同「Look 圖表」或「探索」的「資料」專區中的資料表。
資料值
在「資料值」部分，選擇下載的查詢結果顯示方式：
- 如果選擇「未格式化」，Looker 就不會對查詢結果套用任何特殊格式，例如將較長的數字無條件進位，或是加入 Looker 開發人員可能設定好的特殊字元。如果資料會匯入其他工具並進行處理，通常建議取消勾選這個選項。
- 如果選擇「已格式化」，資料的外觀會與 Looker 的「探索」體驗類似，但部分功能 (例如連結) 並非所有檔案類型都支援。舉例來說，使用
html參數套用的任何格式，都不會套用至 TXT、CSV、Excel 或 JSON 下載內容。
要納入的資料列與資料欄數量
您可以選擇要下載的資料量，方法如下：
- 目前結果表格：內容列數上限指定的列數。
- 所有結果：查詢傳回的所有結果。選取這個選項前，請先參閱本頁面的「所有結果」一節。
- 自訂：自訂列數。具有
download_with_limit權限的使用者最多只能匯出 5,000 個資料列。其他使用者的上限通常為 100,000 人。
所有結果
在 Look 或「探索」中選取「執行」時，Looker 會檢查您的權限，並判斷查詢的複雜度和資料庫方言是否允許下載整個查詢。如果您有權限 (可查看超過設定上限的結果)，且 Looker 判斷可下載整個查詢，則「下載」視窗中會顯示「所有結果」選項。
如果查詢符合下列任一條件，系統通常會停用「所有結果」選項：
- 包含列總計或資料表計算
- 使用「總數百分比」、「與前一期相比的百分比」或「累積總計」類型的指標
- 從無法串流結果的資料庫方言擷取資料
- 納入 Looker 計算的資料透視欄，因為資料來自無法計算資料透視的資料庫方言
即使有「所有結果」選項，下載所有結果時仍應謹慎。部分查詢非常龐大，包含成千上萬或數百萬列，這可能會超出大多數試算表程式的負荷，甚至導致 Looker 執行個體不堪重負。
如果無法使用「所有結果」選項，請改用「自訂」選項，指定權限允許的資料列數量上限。
串流查詢結果
串流是指 Looker 能以區塊處理資料，而非一次處理所有資料。如果 Looker 可以串流結果集，就能無限次下載。「所有結果」選項取決於 Looker 串流結果的能力，如果無法串流結果，則無法使用「所有結果」選項。
除了格式限制外，以下兩種情況也無法串流播放：
- 資料表計算：無法串流資料表計算。因此，如要下載查詢的無限量結果，請從查詢中移除資料表計算。
- 資料庫限制：如果查詢中包含樞紐，部分資料庫就無法串流。如要下載這類資料庫的無限量結果，請移除樞紐。部分資料庫無法串流播放任何結果，因此無法無限次下載。
這些資料庫支援串流：
| 方言 | 是否支援？ |
|---|---|
| Actian Avalanche | 是 |
| Amazon Athena | 是 |
| Amazon Aurora MySQL | 是 |
| Amazon Redshift | 是 |
| Amazon Redshift 2.1+ | 是 |
| Amazon Redshift Serverless 2.1+ | 是 |
| 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+ with Native Driver | 是 |
| Cloudera Impala with Native Driver | 是 |
| 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 pre-9.5 | 是 |
| PrestoDB | 是 |
| PrestoSQL | 是 |
| SAP HANA | 否 |
| SAP HANA 2+ | 否 |
| SingleStore | 是 |
| SingleStore 7+ | 是 |
| Snowflake | 是 |
| Teradata | 是 |
| Trino | 是 |
| Vector | 是 |
| Vertica | 是 |
下列資料庫支援套用樞紐的串流：
| 方言 | 是否支援？ |
|---|---|
| Actian Avalanche | 是 |
| Amazon Athena | 是 |
| Amazon Aurora MySQL | 否 |
| Amazon Redshift | 是 |
| Amazon Redshift 2.1+ | 是 |
| Amazon Redshift Serverless 2.1+ | 是 |
| 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+ with Native Driver | 是 |
| Cloudera Impala with Native Driver | 是 |
| 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 pre-9.5 | 是 |
| PrestoDB | 是 |
| PrestoSQL | 是 |
| SAP HANA | 否 |
| SAP HANA 2+ | 否 |
| SingleStore | 是 |
| SingleStore 7+ | 是 |
| Snowflake | 是 |
| Teradata | 是 |
| Trino | 是 |
| Vector | 是 |
| Vertica | 是 |
移除查詢中的所有排序方式
選取「所有結果」時，您也可能會看到「移除查詢中的所有排序方式」選項。這個選項可避免系統在您下載結果前對查詢進行排序。選取這個選項可能會加快下載速度，因為對特定資料庫類型而言，排序查詢可能會耗用大量效能。
樞紐分析結果不支援「移除查詢中的所有排序方式」選項。
允許大型結果
在 Looker 中使用 Google BigQuery 做為資料庫方言下載大型結果集，並選取「所有結果」時，可能會看到「允許大型結果」選項。這是因為 Google BigQuery 對查詢結果設有回應大小上限，如「寫入查詢結果」Google Cloud 說明文件主題所述。如要下載超過 BigQuery 回應大小上限的結果，Looker 必須執行不同的程序。
如果選取「允許大型結果」，下載程序會受到下列影響：
- 查詢的
allowLargeResultsBigQuery 選項設為true。 - 系統會移除查詢中的
ORDER BY子句。 - 查詢會寫入 PDT 暫時結構定義，因此需要寫入該結構定義的權限。
- 查詢結果會儲存在這個暫時性暫存結構定義中，並以隨機資料表名稱儲存一小時。
下載或在瀏覽器中開啟
選取所需選項後，您可以選取「下載」按鈕，將檔案下載到電腦，也可以選取「在瀏覽器中開啟」，在瀏覽器中查看檔案。
從合併結果查詢下載資料
如要下載合併結果查詢，您可以將查詢儲存至資訊主頁，然後將資訊主頁下載為 PDF 或 CSV 檔案集合。不過，您必須下載整個資訊主頁，無法只下載以合併結果查詢為依據的單一圖塊資料。
從資訊主頁下載資料
如要下載整個資訊主頁，請從資訊主頁的三點選單 中選取「下載」。
系統會開啟對話方塊，讓您選取 PDF 或 CSV 做為下載格式。
將資訊主頁下載為 PDF
您可以將整個資訊主頁下載為 PDF，也就是說，您會取得顯示資訊主頁標題、所有資訊主頁篩選器、部分或所有資訊主頁圖塊，以及資訊主頁執行時區的 PDF。PDF 檔案也會包含時間戳記，顯示資訊主頁的下載時間。
即使您處於開發模式，下載 PDF 格式的資料時，系統一律會傳回模型中的資料，就像處於正式環境模式一樣。
如要將資訊主頁下載為 PDF，請按照下列步驟操作：
- 從「格式」下拉式選單中選取「PDF」。
從「紙張大小」下拉式選單中選取所需選項：
系統預設會選取「將頁面調整為符合資訊主頁」選項，將 PDF 調整為資訊主頁的預設寬度 (1260 像素)。其他紙張大小選項會將 PDF 調整為標準紙張大小，並將整個或部分資訊主頁納入其中。視資訊主頁的版面配置和所選紙張大小而定，在 Looker 中查看時，部分 PDF 輸出內容可能與資訊主頁版面配置不同。舉例來說，如果選取的紙張大小比資訊主頁窄，可能會發生間距或其他格式問題，因此需要進行一些調整：
- 如果視覺化效果或重疊圖塊群組過大，可能需要調整大小才能放入 PDF。
- 如果圖塊包含表格，PDF 可能不會顯示所有表格欄。
- 為配合 PDF 寬度，圖塊可能會縮小。同樣地，如果圖塊在 Looker 應用程式中需要捲動才能顯示，可能不會展開顯示所有內容。
如果沒有看到「紙張大小」選項，請與 Looker 管理員聯絡，為 Looker 執行個體安裝最新版 Chromium 轉譯器。
如果從「紙張大小」下拉式選單中選取「將頁面調整為適合資訊主頁」以外的選項，系統會顯示「方向」選項。你可以選擇將資訊主頁設為直向或橫向。
選取或取消選取「展開資料表，顯示所有資料列」。如果選取這個選項，對於使用表格視覺化效果的資訊主頁圖塊，PDF 檔會顯示表格視覺化效果中的所有列，而不只是資訊主頁圖塊縮圖中顯示的列。如未選取這個選項，PDF 中只會顯示縮圖中未捲動時可見的列。系統仍會套用資訊主頁和查詢篩選器，以及視覺化設定，例如資料列限制、資料欄限制，以及使用「限制顯示的資料列」選項所做的設定。
如果選取「展開資料表，顯示所有資料列」選項，含有表格視覺化圖表的資訊主頁動態磚在下載的 PDF 中，可能與在 Looker 內顯示的內容略有不同。PDF 中可能會出現下列差異：
- 系統會移除欄標題和子總計列的背景顏色和字型大小自訂設定。
- 如未設定自訂主題，表格會以白色主題顯示。否則，系統會在下載時套用自訂主題。
- 如果資料透視表未手動排序，就不會顯示排序圖示。
- 啟用「將資料欄調整為適當大小」的表格會延展至圖塊的完整寬度。
此外，如果表格超過 20,000 個儲存格，PDF 檔案可能會出現下列差異：
如果沒有看到「展開表格以顯示所有資料列」選項，請與 Looker 管理員聯絡，為 Looker 執行個體安裝適當版本的 Chromium 轉譯器。
選取或取消選取「在單一資料欄中排列顯示資訊主頁圖塊」。選取這個選項後，PDF 檔案會以單一直欄顯示資訊主頁圖塊。如果未選取這個選項，資訊主頁動態磚會按照資訊主頁中的排列方式顯示。
選取「在瀏覽器中開啟」，即可在瀏覽器的新分頁中查看 PDF 的圖片。接著，你可以使用瀏覽器的控制選項下載 PDF。
如不想再下載資訊主頁，請選取「取消」。
選取「下載」即可開始下載。瀏覽器會開啟新分頁，顯示下載狀態。
以 CSV 格式下載資訊主頁
您可以從資訊主頁下載所有查詢圖塊，並以 CSV 檔案的壓縮集合形式儲存。ZIP 檔案不包含文字圖塊。如要將資訊主頁下載為 CSV 檔案集合，請按照下列步驟操作：
- 從「格式」下拉式選單中選取「CSV」。
- 如不想再下載資訊主頁，請選取「取消」。
- 選取「下載」，開始下載 CSV 檔案的 ZIP 壓縮檔。
以 CSV 檔案格式下載資訊主頁時，無法使用格式化下載選項，例如設定自訂資料列上限或選擇所有結果。下載檔案的列數上限與對應圖塊的列數上限相關。
Looker 會使用 UTF-8 編碼產生壓縮檔。如果 CSV 檔案名稱中的字元顯示亂碼，可能是因為 Looker 的 UTF-8 編碼與電腦作業系統或第三方應用程式的預設編碼發生衝突。Looker 建議使用可辨識 UTF-8 的檔案解壓縮工具 (例如 7-Zip)，並確保所有第三方應用程式都已設定為支援 UTF-8。
從資訊主頁圖塊下載資料
您無法下載根據合併結果查詢的資訊主頁圖塊資料，但如果將資訊主頁下載為 PDF 或下載為 CSV 檔案集合，系統會一併下載合併結果圖塊的資料。
如要從資訊主頁圖塊下載資料，請選取圖塊上的三點圖示，然後選取「下載資料」：
系統會開啟對話方塊，顯示與Look 或探索類似的選項。展開「進階資料選項」選單，即可查看所有可用的下載選項：
格式
您可以從資訊主頁動態磚下載下列格式的資料：
- TXT (定位點分隔值)
- Excel 試算表 (Excel 2007 以上版本)
- CSV
- JSON
- HTML
- Markdown
- PNG (圖表圖片)
視您選取的格式而定，「進階資料選項」選單中的部分選項可能無法使用。
如果缺少 HTML 或 PNG (視覺化圖片) 選項，請與 Looker 管理員聯絡，為 Looker 執行個體安裝適當版本的 Chromium 轉譯器。
如果是 JSON 格式，Looker 會使用欄位標籤做為 JSON 輸出內容的顯示值。如要進一步瞭解 Looker 如何以 JSON 格式算繪欄位，請參閱「JSON 格式變更」社群貼文。
轉置表格圖表只會以 PDF 和 PNG 格式下載。
即使您處於開發模式，下載 PNG 格式的檔案時，系統一律會傳回正式環境模式中的模型資料。
結果
在「結果」部分中，選擇是否要將視覺化設定套用至資料下載內容：
如果選擇「已套用圖表選項」，Looker 會將部分圖表設定套用至下載內容。在「繪圖」、「系列」和「格式」選單中，為資料下載套用視覺化設定：
- 顯示資料列數
- 隱藏總計
- 隱藏資料列總計
- 限制顯示的資料列：最多可顯示或隱藏 500 列。
- 顯示完整欄位名稱
- 每個資料欄的自訂標籤 (Looker 會使用欄位標籤做為 JSON 輸出中的顯示值。如要進一步瞭解 {looker_name_short}} 如何以 JSON 格式算繪欄位，請參閱「JSON 格式的變更」Looker 社群貼文。
- 以 Excel 格式下載表格圖表時，條件式格式設定會一併下載。
只有套用「沿著比例尺」規則時，以 Excel 格式下載的表格圖表才會顯示條件式格式設定。
如果查詢包含下列任一元素，手動重新排列的表格圖表資料欄在下載時，會以原始順序顯示：
如果選擇「如資料表中所示」，系統就不會套用圖表選項，下載的資料會如同「Look 圖表」或「探索」的「資料」專區中的資料表。
資料值
在「資料值」部分，選擇下載結果的顯示方式：
- 如果選擇「已格式化」，資料的呈現方式會與 Looker 的「探索」體驗較為相似，但部分功能 (例如連結) 並非所有檔案格式都支援。
- 如果選擇「未格式化」，Looker 就不會對結果套用任何特殊格式，例如將較長的數字無條件進位，或是加入 Looker 開發人員可能設定好的特殊字元。如果資料會匯入其他工具並進行處理，通常建議取消勾選這個選項。
要納入的資料列與資料欄數量
您可以在這個部分指定要下載多少資料。在大多數圖塊中，下載彈出式視窗的這部分會命名為「要納入的資料列數量」；如果圖塊查詢包含任何樞紐維度，這部分會命名為「要納入的資料列與資料欄數量」。可用的選項包括：
- 目前結果資料表：圖塊基礎資料表指定的列數上限，以及欄數上限 (如果圖塊查詢包含至少一個透視維度)。
- 所有結果：圖塊查詢傳回的所有結果，即使圖塊的資料表指定了更嚴格的列數或欄數限制也一樣。選取這個選項前，請先參閱本頁的「使用『所有結果』或『自訂』選項時的注意事項」一節。如果使用者沒有
download_without_limit權限，就不會看到這個選項。 - 自訂：下載自訂列數的資料。具備
download_with_limit權限的使用者最多只能匯出 5,000 列。除非 Looker 管理員已提高上限 (請參閱舊版功能：允許無限次下載 (Looker 4.14 以上版本) 社群貼文)，否則其他使用者通常有 10 萬次下載限制。
使用「所有結果」或「自訂」選項時的注意事項
Looker 會檢查您的權限，並判斷查詢的複雜度和資料庫方言是否允許下載整個查詢。如果您有權限下載超過上限的結果，且 Looker 判斷可以下載整個查詢，則「下載」視窗中會顯示「所有結果」選項。
如果查詢符合下列條件，系統通常會停用「所有結果」選項：
即使有「所有結果」選項，下載所有結果時仍應謹慎。部分查詢非常龐大，包含成千上萬或數百萬列，這可能會超出大多數試算表程式的負荷，甚至導致 Looker 執行個體不堪重負。
如果無法使用「所有結果」選項，請改用「自訂」選項，指定權限允許的資料列數量上限。選取「自訂」後，即可指定要下載的結果資料列數量。如果查詢包含任何透視維度，您也可以指定要下載的資料欄數量。
管理員：為 Looker 執行個體啟用資料下載功能
如要使用特定下載選項，客戶代管 Looker 部署作業的管理員必須安裝適當版本的 Chromium 轉譯器。如果執行個體是由 Looker 代管，則 Chromium 已安裝完畢。
「管理商家使用者功能」說明文件頁面提供下載程序的重要管理員資訊：
如要進一步瞭解必須指派給使用者的權限 (具體來說是 download_with_limit 和 download_without_limit 權限)，請參閱角色說明文件頁面。