本頁列出 Looker 各處的資料列限制。基本原則如下:
- 如果結果顯示在瀏覽器中,預設資料列限制為 5,000 列,如果管理員指定較高的限制,則最多可達 50,000 列。
- 如果從 Looker 匯出結果,使用者可以選擇匯出「所有結果」。不過,如果查詢無法串流,就無法使用「所有結果」選項。如要瞭解使用「所有結果」下載內容的限制,請參閱「下載內容」說明文件頁面。
-
如果使用 Looker 排程器以 Look 或探索的形式傳送結果,使用者可以選擇傳送「所有結果」。自 Looker 26.2 起,只有獲派
schedule_without_limit權限的使用者,才能在 Look 圖表和探索的傳送作業中,看到「所有結果」選項。如要瞭解傳送「所有結果」內容的限制,請參閱「傳送圖表和探索」說明文件頁面。
探索、Look、資訊主頁、SQL Runner
使用「探索」頁面建立的查詢最多只能有 5,000 列。 這項限制也適用於在 SQL Runner 中建立的 Look、資訊主頁和查詢。
下載中
在多數情況下,您可以從探索、Look 圖表或資訊主頁下載不限數量的結果集。只有在結果集串流,且下載的使用者具備 download_without_limit 權限時,才能下載所有結果。
如未符合這些條件,則可在下載模式中設定自訂限制。具備 download_with_limit 權限的使用者最多只能查看 5,000 列 (如果在圖表限制中設定較高上限,則最多可查看 50,000 列) 和 50 欄。這項自訂限制對其他使用者預設為最多 100,000 列,有時會被誤解為每位使用者或每個角色的限制。
Looker 原生不支援依使用者或角色,設定精細的自訂資料列下載限制 (例如 100,000 列)。自訂下載資料列限制的任何變更,都會套用為執行個體層級設定,影響所有使用者。
如要強制執行自訂資料列下載上限,可以修改 Looker 執行個體的 max-unstreamed-limit 啟動旗標。如果將這個啟動旗標設為 100,000,執行個體上的所有使用者最多只能下載 100,000 列。
提交內容
只要結果串流,排定傳送至電子郵件的資料量上限為 20 MB (內嵌內容的電子郵件) 或 15 MB (含附件的電子郵件)。套用「所有結果」選項的所有電子郵件,都受限於 20 MB 或 15 MB 的大小限制。只有具備內容基礎模型 schedule_without_limit 權限的使用者,才會看到「所有結果」選項。
透過 Webhook 或傳送至 Amazon S3 bucket 或 SFTP 伺服器的排程,可以傳送無限的結果集,只要資料能以傳回的方式傳送,而不是一次全部傳送。只有具備內容基礎模型 schedule_without_limit 權限的使用者,才能看到「所有結果」選項。
檔案格式
下載或傳送內容時,PDF 和 PNG 檔案格式會維持瀏覽器資料列上限 5,000 筆。「所有結果」選項通常僅適用於 Markdown、文字、CSV、JSON - 簡易、XLSX 或 HTML 格式,可用於排程、傳送和下載。傳送及排定傳送資料時,可用的資料格式取決於目的地和內容類型。「使用 Looker 排程器傳送內容」說明文件頁面提供各種 Looker 內容傳送方式的說明文件連結。如要進一步瞭解可下載的檔案格式選項,請參閱「下載內容」說明文件頁面。
API
API 呼叫受限於呼叫時的資料列限制。根據探索、Look 圖表或資訊主頁發出的 API 呼叫,資料列上限為 5,000 列,但某些下載和排程檔案格式則不受限制。
如要使用 API 下載不限數量的結果,請使用適當的 Run 呼叫 (例如 Run Inline Query 或 Run Look),並將 limit 參數設為 -1 (負一)。-1 是 Looker 用來代表不限結果數量的數字。
請根據您使用的 API 呼叫類型,查看這些章節中提及的限制。