本頁面概略說明如何將圖表和探索結果,傳送至 Looker 內建的傳送目的地,以及 Looker 執行個體可用的任何整合服務。如要瞭解如何排定資訊主頁,請參閱「排定時間和傳送資訊主頁」說明文件頁面。
Looker 排程器是 Looker 使用者介面的一部分,可用來設定內容上傳設定。如果是圖表,您可以使用排程器傳送一次性或週期性內容。探索資料只能傳送一次。如要排定定期傳送「探索」內容,必須先將內容儲存為 Look 圖表。
從資料夾開啟排程器
如要從資料夾或子資料夾中開啟排程器,請找出含有要傳送資訊主頁的資料夾或子資料夾。前往資料夾時,資料夾中的所有 Look 圖表和資訊主頁都會以清單檢視或格狀檢視列出。
日曆圖示表示你已為該內容排定至少一項週期性傳送作業 (在格狀檢視中,你必須將滑鼠游標懸停在內容縮圖上,才能看到日曆圖示,如果有的話)。
![]()
在清單檢視中,您可以透過下列方式開啟排程器:
- 點選項目的日曆圖示 (如有)
- 按一下項目的三點圖示選單,然後選擇「編輯排程」 (如果項目已有排程)、「新增排程」 (如果項目尚未有排程) 或「傳送」 (建立一次性傳送作業)
- 開啟內容,按一下右上方的齒輪選單,然後選擇「排定」 (定期傳送) 或「傳送」 (一次性傳送)
在格狀檢視中,您可以透過下列方式開啟排程器:
- 點選項目的日曆圖示 (如有)
- 開啟內容,按一下右上方的齒輪選單,然後選擇「排定」 (定期傳送) 或「傳送」 (一次性傳送)
建立推送作業
如要從 Looker 內容建立傳送作業,請按一下內容右上方的齒輪選單,然後選擇「排程」 (定期傳送) 或「傳送」 (一次性傳送),開啟舊版排程器。
如果是週期性傳送,舊版排程器的左側面板會顯示為內容建立的所有排程,並醒目顯示您正在建立或編輯的排程標題。左側面板會依上次更新時間,由新到舊列出時間表。如要複製或刪除現有時間表,請按一下時間表右側的「複製」或「刪除」圖示。
如果這是你為這項內容建立的第一個時間表,主面板會顯示設為預設值的時間表選項。您可以視需要修改這些值。如果你先前已為這項內容建立一或多個排程,主面板會顯示清單頂端排程的已儲存排程設定。接著:
- 如要編輯現有時間表的選項,請選取該時間表,然後視需要變更選項。完成後,按一下「全部儲存」。
- 如要為同一內容建立其他時間表,請按一下「新增」,然後輸入該時間表的設定。
完成後,按一下「全部儲存」。
以下各節將說明各項排程設定。
命名上傳作業
在「為時間表命名」欄位中,輸入不重複的時間表名稱。儲存時間表後,標題會顯示在左側面板的已建立時間表清單,以及管理面板的時間表管理頁面。
視提交目的地而定,標題也可能顯示在其他位置:
- 如果是透過電子郵件傳送,標題會用於電子郵件的主旨行。如果您選取的格式使用電子郵件附件,標題也會用於檔案名稱的一部分。
- 如果是 Webhook,標題會包含在 Webhook 酬載的「Title」欄位中。
- 如要傳送至 Amazon S3 bucket,標題會用於傳送檔案名稱和傳送的任何錯誤電子郵件。傳送檔案的名稱格式為
TITLE_TIMESTAMP_HASH,其中HASH是隨機的六字元 ID,TIMESTAMP則採用YYYY-MM-DDTHHMM模式 (例如,2019 年 5 月 31 日上午 9:33 的時間戳記部分會顯示為2019-05-31T0933)。時間戳記的時區會與排程的「傳送時區」一致。 - 如果傳送至整合服務時會產生檔案附件,傳送檔案的名稱會包含標題。
如果是 SFTP 提交,標題會包含在提交的檔案名稱中。傳送檔案的檔案名稱格式為
TITLE_TIMESTAMP_TOKEN,其中TOKEN是隨機的六字元 ID,TIMESTAMP則採用YYYY-MM-DDTHHMM模式 (例如,2019 年 5 月 31 日上午 9:33 的時間戳記部分會顯示為2019-05-31T0933)。時間戳記的時區會與排程的「傳送時區」一致。如果是 SFTP 傳送,傳送檔案名稱只能使用英數字元、底線 (_) 和連字號 (-)。Looker 會從您在「為排程命名」欄位中輸入的內容,移除
A-Z、a-z、0-9、_或-以外的所有字元。
選擇傳送目的地
「這項資料應傳送至何處?」設定可能會顯示多個資料傳送目的地選項。每個目的地提供的運送選項不盡相同。
目的地包括:
- 電子郵件
- webhook
- Amazon S3 儲存貯體
- SFTP
- Looker 管理員為執行個體啟用的任何整合服務。如要查看可傳送 Look 圖表和探索結果的服務清單,請參閱本頁的「第三方整合服務的傳送選項」一節
選取資料目的地後,系統會顯示新的設定欄位,供您新增該目的地的具體詳細資料,例如電子郵件地址或 Webhook 網址。
電子郵件傳送選項
在「這項資料應傳送至何處?」部分,選擇「電子郵件」。系統會將內容傳送至您指定的電子郵件地址清單。
在「要透過電子郵件傳送給誰」部分,輸入收件者的電子郵件地址。輸入單一電子郵件地址,或輸入多個地址並以半形逗號分隔,然後按一下「新增」。可新增的收件者數量沒有上限。
視 Looker 執行個體的設定和指派的權限而定,您或許可以將電子郵件傳送至未與 Looker 執行個體上任何使用者帳戶相關聯的電子郵件地址。這類郵件會歸類為外部電子郵件。如要將內容傳送給外部使用者,Looker 管理員必須授予您將內容傳送給外部使用者的權限,或將這些收件者的電子郵件網域加入排定內容的電子郵件網域許可清單。
如果收件者是其他 Looker 使用者,除非 Looker 管理員將 Looker 執行個體的電子郵件資料政策設為「僅傳送資料」,或取消選取「加入連結」選項,否則收件者會看到從電子郵件連結回資訊主頁的選項。
如果所有收件者都取消訂閱已排定傳送時間的電子郵件,該排程就會從 Looker 中刪除,包括使用者和管理員的排程管理頁面。如果收件者代表電子郵件群組取消訂閱,該群組的所有成員都不會收到已排定傳送時間的電子郵件。
如要進一步瞭解電子郵件傳送,請參閱本頁的「套用進階傳送選項」一節。
勾選「加入自訂訊息」,在電子郵件內文中加入自訂訊息。Looker 的自訂訊息長度上限為 1,500 個半形字元。
透過電子郵件傳送的資料,大小不得超過 20 MB (適用於在電子郵件內文中傳送的格式) 和 15 MB (適用於以附件形式傳送的格式)。
Webhook 傳送選項
Webhook 越來越常用於觸發網際網路服務之間的交換。搭配 Zapier 等網路服務,Webhook 可將 Looker 資料傳送至多種應用程式。舉例來說,您可以排定定期將 Look 或資訊主頁傳送至 Webhook。設定傳送作業時,Looker 會提示您輸入 Webhook 位址。
在「這項資料應傳送至何處?」部分,選擇「Webhook」。在「Webhook 網址」部分,輸入 Looker 應傳送 HTTPS 要求來傳送這項資料的網址。您可以從用於處理 Webhook 的網路服務取得這個網址。 如要設定 Webhook,請前往網路服務並執行下列操作:
- 取得 Looker 應傳送 HTTPS 要求的網址。
- 指定 Looker 資料傳送的目的地應用程式。目的地應用程式可能需要額外設定,才能接收 Looker 的資料。
確切程序會因您用來傳送資訊主頁的網路服務和目的地應用程式而異。請參閱這篇 Looker 社群貼文:使用 Webhook 排定 Look 圖表和資訊主頁 (3.46+),瞭解如何設定其他應用程式來接收 Looker 的 Webhook 資料。
Looker 會嘗試將資料傳送至 Webhook,最長 30 分鐘。請確保目的地能在 30 分鐘內回應 Webhook 傳送嘗試。
Amazon S3 bucket 的傳送選項
Amazon S3 bucket 是儲存大量資料的常見方式。您或貴公司必須先在 Amazon 建立 S3 值區,Looker 才能使用。
如果選擇 Amazon S3 目的地選項,Looker 會提示您進行其他設定,包括格式和 Amazon S3 bucket,如本頁所述。如要進一步瞭解如何使用 Amazon S3 bucket 傳送資料,請參閱這篇 Looker 社群貼文:將 (無限) 結果排定傳送至 S3。
在「這項資料應傳送至何處?」部分,選擇「Amazon S3」。「S3 Details」(S3 詳細資料) 專區隨即顯示,並提示您輸入 Amazon S3 bucket 的相關資訊:
- Bucket:Amazon S3 bucket 的名稱。
- 選用路徑:要儲存資料的資料夾 (如有)。
- 存取金鑰:Amazon 提供的 S3 bucket 存取金鑰 ID。
- 私密金鑰:Amazon 提供的 S3 bucket 私密存取金鑰。
- 區域:託管 S3 bucket 的 Amazon 服務區域。
SFTP 伺服器的傳送選項
在「這項資料應傳送至何處?」部分選擇「SFTP」,將內容傳送至 SFTP 伺服器。如果資料或圖表太大,無法透過電子郵件傳送,建議將結果傳送至 SFTP 伺服器。如果選擇這個傳送選項,Looker 會提示您輸入 SFTP 伺服器位址、使用者名稱和密碼,如下所述。
請注意下列 SFTP 提交相關事項:
- 如要接收 Looker 的 SFTP 傳送內容,請務必請網路管理員將 Looker 的 IP 位址新增至 SFTP 伺服器的 IP 許可清單或傳入流量規則。
- 傳送至 SFTP 伺服器時,傳送檔案名稱只能使用英數字元、底線 (_) 和連字號 (-)。Looker 會從您在「為排程命名」欄位中輸入的內容,移除
A-Z、a-z、0-9、_或-以外的所有字元。
如果選擇「SFTP」SFTP,Looker 會提示您輸入伺服器的網址和登入資訊:
位址:要傳送資料的安全檔案傳輸通訊協定伺服器網址或 IP 位址。例如:
sftp://files.looker.com/Marketing/In/sftp://192.168.0.10/Marketing/In/
這個範例網址以
/字元結尾。這表示檔案會儲存在名為In的資料夾中。如果省略結尾的/,檔案會儲存在Marketing資料夾中,且檔案名稱會加上「In」前置字元。您必須具備要建立檔案的資料夾寫入權限。使用者名稱和密碼:SFTP 伺服器的登入憑證
偏好的金鑰交換演算法:這是選填欄位。如要設定,請選擇建立連線時偏好的安全殼層金鑰交換演算法。支援的選項如下:
ecdh-sha2-nistp521ecdh-sha2-nistp384ecdh-sha2-nistp256diffie-hellman-group-exchange-sha256diffie-hellman-group14-sha256diffie-hellman-group14-sha1
如果五分鐘內未建立連線,請選擇其他演算法。部分演算法需要較長時間才能產生安全殼層金鑰。這個選項可讓您使用可能耗時較短的演算法。選擇其中一種演算法後,該演算法就會成為建立 SSH 連線的首選演算法。如果伺服器不支援該演算法,後續嘗試會使用所有其他演算法。如果這個欄位設為「Default」,系統會使用連線程式庫中演算法的原始順序。
SFTP 支援僅限使用者名稱和密碼憑證。不支援 SSH 私密金鑰憑證。
Looker SFTP 傳送作業支援的主機金鑰演算法如下:
ssh-ed25519-cert-v01@openssh.comssh-ed25519ecdsa-sha2-nistp521-cert-v01@openssh.comecdsa-sha2-nistp384-cert-v01@openssh.comecdsa-sha2-nistp256-cert-v01@openssh.comecdsa-sha2-nistp521ecdsa-sha2-nistp384ecdsa-sha2-nistp256ssh-rsa-cert-v01@openssh.comssh-rsa-cert-v00@openssh.comssh-rsarsa-sha2-256rsa-sha2-512
Looker SFTP 傳送功能支援的加密演算法 (加密) 如下:
aes256-ctraes192-ctraes128-ctraes256-gcm@openssh.comaes128-gcm@openssh.com
Looker SFTP 傳送作業支援的訊息驗證碼演算法如下:
hmac-sha2-512-etm@openssh.comhmac-sha2-256-etm@openssh.comhmac-sha2-512hmac-sha2-256hmac-sha1
Looker 會將檔案上傳至 SFTP 伺服器上的指定目錄,並採用下列檔案命名慣例:
<name>_<timestamp>_<token>.<file extension>
<name>是您在「Give your schedule a name」(為排程命名) 欄位中提供的名稱,Looker 會移除A-Z、a-z、0-9、_或-以外的所有字元<timestamp>是傳送時間表的日期和時間,格式為%Y-%m-%dT%H%M<token>是由隨機六字元字串組成的權杖<file extension>是副檔名
例如:Test_Schedule_2019-04-11T1130_HWkvys.csv
第三方整合服務的傳送選項
您可以排定或傳送 Look 圖表或探索結果,到與 Looker 整合的服務,例如 Slack、Dropbox、Google 雲端硬碟等。整合功能必須由 Looker 管理員啟用。Looker 管理員必須明確授予使用者和嵌入使用者權限,才能將資料傳送及排定傳送至第三方整合服務。
在排程器的「目的地」欄位中選取整合服務後,可能會出現幾個新欄位,提示您提供更多資訊。
下列清單顯示可接收 Look 或探索結果的 Looker Action Hub 服務。
清單使用方式如下:
- 「Link to README file」(README 檔案連結) 欄中的網址提供操作說明,說明如何啟用及設定整合服務,以便與 Looker 搭配使用。
- 「How to use this integration」(如何使用這項整合功能) 欄中的網址,提供如何將資料從 Looker 傳送至整合服務的操作說明。部分文章也包含啟用操作說明。
- 「必要 LookML 標記」會列出所有必要標記,這些標記必須與內容基礎模型中的
tags參數搭配使用。 - 「動作類型」表示整合服務傳送的資料層級:欄位、查詢或資訊主頁。欄位層級動作會傳送資料表中單一指定儲存格的值。查詢層級動作會傳送整個查詢的結果,例如探索或 Look 中的所有資料列。資訊主頁層級動作會傳送資訊主頁的圖片。
- 「使用 Google OAuth 驗證」指出整合服務是否使用 Google OAuth 憑證進行驗證。
- 「Uses data streaming」指出整合式服務是否支援串流查詢結果。
| 整合服務 | 說明 | README 檔案連結 | 如何使用這項整合功能 | 必要的 LookML 標記 | 動作類型 | 使用 Google OAuth 驗證 (是/否) | 是否使用資料串流 |
|---|---|---|---|---|---|---|---|
| Airtable | 在 Airtable 的表格中新增記錄。 | 前往 GitHub 查看 README | 查看社群文章 | 無 | 查詢 | 否 | 否 |
| Amazon SageMaker Infer | 使用 Amazon SageMaker 執行推論。 | 沒有可用的 README | 沒有相關的文章 | 無 | 查詢 | 否 | 是 |
| Amazon SageMaker 訓練:線性學習器 | 使用 Linear Learner 演算法,在 Amazon SageMaker 啟動訓練工作。 | 沒有可用的 README | 沒有相關的文章 | 無 | 查詢 | 否 | 是 |
| Amazon SageMaker 訓練:Xgboost | 使用 Xgboost 演算法,在 Amazon SageMaker 啟動訓練工作。 | 沒有可用的 README | 沒有相關的文章 | 無 | 查詢 | 否 | 是 |
| Amazon Web Services EC2 停止執行個體 | 使用 Amazon EC2 API 停止 EC2 執行個體。 | 前往 GitHub 查看 README | 查看社群文章 | aws_resource_id | 欄位、查詢 | 否 | 否 |
| 水管疏通器 | 使用查詢結果建立預測模型。 | 前往 GitHub 查看 README | 查看 README | 無 | 查詢 | 否 | 是 |
| Azure 儲存體 | 將資料檔案傳送並儲存至 Azure Storage。 | 前往 GitHub 查看 README | 查看社群文章 | 無 | 查詢 | 否 | 是 |
| Braze | Braze 動作可讓您使用 Look 的 REST API 端點,在 Braze 中標記使用者。確認結果中有標記 braze_id 欄位。匯出上限:10,000。 |
前往 GitHub 查看 README | 查看 README | braze_id | 查詢 | 否 | 是 |
| DigitalOcean — 停止 Droplet | 使用 DigitalOcean API 停止 DigitalOcean 程序。 | 前往 GitHub 查看 README | 查看社群文章 | digitalocean_droplet_id | 欄位、查詢 | 否 | 否 |
| DigitalOcean Spaces | 將資料檔案傳送至 DigitalOcean Storage 並儲存。 | 前往 GitHub 查看 README | 查看社群文章 | 無 | 查詢 | 否 | 是 |
| Dropbox | 將資料檔案傳送並儲存至 Dropbox。 | 沒有可用的 README | 查看說明文件 | 無 | 查詢 | 是 | 否 |
| Facebook 自訂目標對象 | 將顧客名單中的資料上傳至 Facebook 廣告自訂廣告受眾。 | 前往 GitHub 查看 README | 查看 README | 無 | 查詢 | 是 | 是 |
| Firebase | 使用 Firebase 將推播通知傳送至行動裝置。 | 沒有可用的 README | 沒有相關的文章 | 無 | 查詢 | 否 | 否 |
| Google Ads 目標顧客比對 | 將資料上傳至 Google Ads 目標顧客比對。 | 前往 GitHub 查看 README | 查看說明文件 | 無 | 查詢 | 是 | 是 |
| Google Analytics 資料匯入 | 將資料上傳至 Google Analytics 資料集。 | 前往 GitHub 查看 README | 查看 README | 無 | 查詢 | 是 | 是 |
| Google Cloud Storage | 將資料檔案寫入 Google Cloud Storage bucket。 | 前往 GitHub 查看 README | 查看社群文章 | 無 | 查詢 | 否 | 是 |
| Google 雲端硬碟 | 將資料傳送至 Google 雲端硬碟。 | 沒有可用的 README | 查看說明文件 | 無 | 查詢 | 是 | 是 |
| Google 試算表 | 將 CSV 資料傳送至 Google 試算表。 | 沒有可用的 README | 查看說明文件 | 無 | 查詢 | 是 | 是 |
| HubSpot 公司 | 使用 Hubspot V3 API 將屬性新增至公司。 | 前往 GitHub 查看 README | 查看 README | hubspot_company_id | 查詢 | 否 | 是 |
| HubSpot 聯絡人 | 使用 Hubspot V3 API 為聯絡人新增屬性。 | 前往 GitHub 查看 README | 查看 README | hubspot_contact_id | 查詢 | 否 | 是 |
| Kloudio | 將資料新增至 Google 試算表。 | 前往 GitHub 查看 README | 查看 README | 無 | 查詢 | 否 | 否 |
| mParticle | 將使用者或事件資料從 Looker 大量匯出至 mParticle。 | 前往 GitHub 查看 README | 查看 README | 查看 README | 查詢 | 否 | 是 |
| Salesforce 廣告活動 | 將聯絡人或待開發客戶新增至 Salesforce 廣告活動。 | 前往 GitHub 查看 README | 查看 README | sfdc_contact_id 或 sfdc_lead_id | 查詢 | 是 | 否 |
| 區隔群組 | 將特徵和/或使用者新增至區隔群組。 | 前往 GitHub 查看 README | 查看說明文件 | segment_group_id 和 user_id,或 segment_group_id 和 segment_anonymous_id | 查詢 | 否 | 是 |
| Segment Identify | 使用 Identify 為 Segment 使用者新增特徵。 | 前往 GitHub 查看 README | 查看說明文件 | email 或 user_id 或 segment_anonymous_id 或 segment_group_id | 查詢 | 否 | 是 |
| 區隔追蹤 | 連結至 Segment 提供的多項整合功能,找出並指定行銷工作流程的使用者。 | 前往 GitHub 查看 README | 查看說明文件 | email 或 user_id 或 segment_anonymous_id 或 segment_group_id | 查詢 | 否 | 是 |
| SendGrid | 使用 SendGrid 的 API 傳送資料,並排定將結果傳送至電子郵件地址。 | 前往 GitHub 查看 README | 查看社群文章 | 無 | 查詢 | 否 | 否 |
| Slack | 使用 OAuth,在 Slack 的即時訊息、公開頻道和私人頻道中傳送 Looker 內容。適用於 6.24 以上版本由 Looker 代管的部署作業,且 IP 許可清單功能已停用。 | 沒有可用的 README | 查看說明文件 | 無 | 查詢 | 是 | 是 |
| Slack 附件 (API 權杖) | 將資料和使用者憑證直接傳送至 Slack 頻道。您也可以參閱 Lookerbot 說明文件,瞭解其他 Slack 功能。 | 前往 GitHub 查看 README | 查看說明文件 | 無 | 查詢 | 否 | 否 |
| Teams - 傳入 Webhook | 使用連入 Webhook 將資料傳送至 Microsoft Teams。 | 前往 GitHub 查看 README | 查看 README | 無 | 查詢 | 否 | 否 |
| 托盤 | 連結 Tray.io 提供的多項整合功能,自動執行工作流程。 | 前往 GitHub 查看 README | 查看社群文章 | 無 | 查詢 | 否 | 是 |
| Twilio - 傳送資料 | 使用 Twilio 的 API,將 Look 的資料或排定的結果傳送至電話號碼。 | 前往 GitHub 查看 README | 查看社群文章 | 無 | 查詢 | 否 | 否 |
| Twilio - 傳送訊息 | 傳送訊息給 Look 圖表中的一系列電話號碼 (標記為電話號碼的資料欄)。 | 前往 GitHub 查看 README | 查看 README | 手機 | 欄位、查詢 | 否 | 否 |
| Zapier | 連結 Zapier 提供的多項整合服務,自動處理工作流程。 | 前往 GitHub 查看 README | 查看社群文章 | 無 | 查詢 | 否 | 是 |
選擇資料格式
Look 和探索會根據傳送目的地,提供不同的格式選項。如要選擇傳送格式,請在排程工具的「將資料格式設為」部分選取適當的圖示。
請參閱下表,瞭解各格式如何傳送至各目的地。
| 格式 | 電子郵件 | Webhook | Amazon S3 | SFTP |
|---|---|---|---|---|
| 資料表 | 電子郵件內文中的資料表 (HTML 格式) | 不適用於這個目的地 | 不適用於這個目的地 | 不適用於這個目的地 |
| 圖表 | 電子郵件內文中的視覺化圖表 (PNG 圖片) | 不適用於這個目的地 | 不適用於這個目的地 | 不適用於這個目的地 |
| CSV | 以半形逗號分隔的文字檔附件形式提供資料表 | 以半形逗號分隔的文字檔附件形式提供資料表 | 以半形逗號分隔的文字檔附件形式提供資料表 | 以半形逗號分隔的文字檔附件形式提供資料表 |
| XLSX | 資料表 (Excel 檔案附件) | 資料表 (Excel 檔案附件) | 資料表 (Excel 檔案附件) | 資料表 (Excel 檔案附件) |
| JSON - 簡易 | 資料表會以 JSON 檔案附件的形式提供。在這個格式中,Looker 會使用維度或測量指標的欄位名稱做為轉譯值,而非欄位的標籤。 | 資料表會以 JSON 檔案附件的形式提供。在這個格式中,Looker 會使用維度或測量指標的欄位名稱做為轉譯值,而非欄位的標籤。 | JSON 檔案附件形式的資料表。在這個格式中,Looker 會使用維度或測量指標的欄位名稱做為顯示值,而非欄位的標籤。 | JSON 檔案附件形式的資料表。在這個格式中,Looker 會使用維度或測量指標的欄位名稱做為轉譯值,而非欄位的標籤。 |
| JSON - 標籤 | 不適用於這個目的地 | JSON 格式的資料表。在這種格式中,Looker 會使用欄位標籤做為 JSON 輸出內容中的轉譯值。 | 不適用於這個目的地 | 不適用於這個目的地 |
| JSON - 簡易、內嵌 | 不適用於這個目的地 | 直接以 JSON 格式提交的資料表。在這個格式中,Looker 會使用維度或測量指標的欄位名稱做為轉譯值,而非欄位的標籤。 | 不適用於這個目的地 | 不適用於這個目的地 |
| JSON - 詳細、內嵌 | 不適用於這個目的地 | 直接以 JSON 格式提交的資料表,其中包含其他詳細資料,例如欄位中繼資料、快取資訊、查詢完成時間,以及查詢執行時間。在這個格式中,Looker 會使用維度或測量指標的欄位名稱做為顯示值,而非欄位的標籤。 | 直接以 JSON 格式提交的資料表,其中包含其他詳細資料,例如欄位中繼資料、快取資訊、查詢完成時間,以及查詢執行時間。在這個格式中,Looker 會使用維度或測量指標的欄位名稱做為轉譯值,而非欄位的標籤。 | 直接以 JSON 格式提交的資料表,其中包含其他詳細資料,例如欄位中繼資料、快取資訊、查詢完成時間,以及查詢執行時間。在這個格式中,Looker 會使用維度或測量指標的欄位名稱做為轉譯值,而非欄位的標籤。 |
| 文字 | 資料表 (定位點分隔文字檔附件) | 資料表 (定位點分隔文字檔附件) | 資料表 (定位點分隔文字檔附件) | 資料表 (定位點分隔文字檔附件) |
| HTML | 資料表 (HTML 檔案附件) | 資料表 (HTML 檔案附件) | 資料表 (HTML 檔案附件) | 資料表 (HTML 檔案附件) |
觸發放送
排定週期性傳送作業時,您可以選擇兩種觸發傳送作業的方式:
- 重複間隔:選取這個選項,即可使用您在本頁「指定傳送週期」部分設定的傳送時間表。
- 資料群組更新:如果 LookML 開發人員已設定資料群組,您可以排定在資料群組觸發、管理快取,並重建相關 PDT 後傳送。
指定資料群組觸發條件
如要使用資料群組觸發條件,請在排程器的「觸發條件」部分選取「資料群組更新」。然後從「Select Datagroup」下拉式選單中選擇來源資料群組。

如要使用資料群組觸發條件排定內容,內容所依據的模型檔案必須包含資料群組。Looker 會列出指定圖表或資訊主頁圖塊中,模型定義的所有資料群組,即便資料群組並未用於處理查詢或 PDT 的快取。
只有在所有使用該資料群組保存的 PDT 完成重新產生程序後,系統才會觸發以資料群組為基礎的排程,確保傳送的資料為最新版本。
指定傳送週期
如果傳送作業使用重複間隔,您可以在「傳送這項排程」部分自訂排程時間。在排程器的「Trigger」(觸發條件) 部分,選取「Repeating interval」(重複間隔)。時間選項會因您選擇「每日」、「每週」、「每月」、「每小時」或「每分鐘」而異。您可以在「進階選項」部分調整時間表的時區。

「每小時」和「每分鐘」間隔的結束時間不包含在內。最後一次傳送會在指定結束時間前的最後一個選定間隔進行。舉例來說,如果內容排定在凌晨 12:00 到晚上 11:00 之間「每小時」傳送,則會在凌晨 12:00 到晚上 10:00 之間,每小時整點傳送。如果內容排定在凌晨 12:00 到晚上 11:00 之間「每分鐘」傳送,則該時間範圍內的最後一次傳送時間為晚上 10:30。
對放送套用篩選條件
如果傳送的圖表或資訊主頁含有篩選器,您可以修改篩選條件,進一步篩選傳送的結果。
按一下「篩選器」,即可查看及修改與這個 Look 或資訊主頁相關聯的篩選器,以便傳送。在排程器中變更這些篩選器選項,不會變更圖表或資訊主頁中的篩選器。如果資訊主頁篩選器需要篩選器值,但排程篩選器為空白,則排程在傳送時不會顯示任何結果。
如果您變更了在 Look 圖表或資訊主頁中做為篩選器的欄位名稱,請務必查看排定的 Look 圖表和資訊主頁的「篩選器」部分,並視需要更新篩選器,以反映變更。如果排定的內容上傳作業包含已失效的「包含」篩選器 (例如參照的欄位已變更),排定的內容上傳作業可能會公開未篩選的資料。
如要進一步自訂傳送作業,可以使用「符合使用者屬性」篩選器選項 (前提是 Looker 管理員已設定使用者專屬值,也就是「使用者屬性」)。將篩選器設為其中一項屬性,系統就會自動為每位使用者自訂結果,也就是說,即使您只傳送一次,也能向多位使用者傳送自訂結果。如要進一步瞭解這項功能,請參閱使用者屬性說明文件頁面。
套用進階放送選項
「進階選項」部分提供其他自訂選項,可讓您調整放送設定。按一下「進階選項」旁的箭頭,展開這個選單。可用的選項取決於所選的目的地和傳送格式,以及您要傳送的是資訊主頁、Look 圖表或探索。下表中的連結會導向各個選項的說明,這些選項可用於將圖表或探索傳送至 Looker 的內建目的地。傳送至第三方整合服務時,可能會有專屬的進階選項。
符合下列條件時傳送這項排程:
如果是週期性傳送 Look 圖表,您可以自訂排程,只在符合特定條件時傳送 Look 圖表內容。快訊則可為資訊主頁圖塊提供類似功能。
在「在下列情況下傳送這份排程」下拉式選單中,指定是否要在有結果、無結果,或不論有無結果時,才傳送 Look 圖表內容。舉例來說,您可以使用篩選器,為要監控的情況建立條件,例如商品庫存量低於特定數量、支出高於特定金額等,然後在達到該條件時才傳送內容。
您也可以勾選「結果在上次執行後有所變動」旁的方塊,指定只有在查詢結果與上次傳送的資料不同時,才傳送資料。如果想使用「所有結果」限制選項,就無法使用這個選項。
限制
您可以為資料選取下列其中一個限制選項,限制傳送大小:
- 表格中的結果:資料會以單一傳送方式傳送。
- 所有結果:系統會串流傳輸傳回的資料,傳送查詢結果中的所有資料列。只有具備
schedule_without_limit權限的使用者,才能看到「All Results」(所有結果) 選項。
如果選擇「資料表中的結果」,Looker 會遵循您在已儲存 Look 圖表或探索中設定的資料列限制。如果選擇「所有結果」,Looker 會傳回查詢的所有資料列,不受任何已儲存的 Look 設定影響,也不受 Looker 的預設資料列限制 (5,000 列) 影響。如要擷取超大型資料集,建議啟用這項設定,但請務必謹慎,確保查詢不會超出資料庫負荷。
電子郵件限制選項
傳送 Look 圖表和探索資料時,您可以限制電子郵件的大小,不得超過電子郵件伺服器的訊息大小上限。為資料選取下列其中一個限制選項:
- 表格中的結果:傳送的資料列數上限為 5,000。如果電子郵件使用資料表或圖表 格式選項,則只能選擇這個選項。Looker 不會傳送資料列超過 5,000 列的電子郵件。
- 所有結果:如果使用文字、CSV、JSON - 簡易、XLSX 或 HTML 格式選項,您可以傳送已儲存 Look 結果的所有資料列。這個選項會忽略針對已儲存 Look 圖表設定的任何限制,或是 Looker 的預設資料列限制 (5,000 列)。不過,電子郵件應用程式有資料總量限制。如果電子郵件內文包含超過 20 MB 的資料,或附件包含超過 15 MB 的資料,Looker 就不會傳送電子郵件。如果您指定「資料表」或「圖表」格式,然後選取「所有結果」,Looker 會自動將格式變更為使用文字附件,以便傳送所有結果。只有具備
schedule_without_limit權限的使用者,才能看到「所有結果」選項。
如要確認已排定傳送時間的電子郵件是否在資料列或資料限制範圍內,您可以輸入自己的電子郵件地址做為收件者,然後按一下「傳送測試」,立即將資料傳送給自己。如果沒有收到電子郵件,可能是因為您已達到電子郵件的資料列或資料量上限。
電子郵件選項
傳送至電子郵件時,還有其他傳送選項,分別是「以收件者身分執行排程」和「加入連結」。
以收件者的身分執行排程
這個選項僅適用於電子郵件目的地。
管理員可透過「以收件者身分執行排程」選項,指定一份使用者清單,讓每位使用者根據自身權限,接收內容傳送,就像他們執行查詢一樣。非管理員使用者也可以輸入自己的電子郵件地址,接收系統根據其權限查詢的內容。也就是說,每封電子郵件中的資料都會套用各使用者的存取權篩選器和使用者屬性。
舉例來說,Looker 管理員需要排定查詢,計算依「州別」分組的「使用者」人數,並將結果傳送給一系列使用者,而每位使用者都有不同的存取權篩選器值。

使用者 A 的存取權篩選器設為 users.state = 'California'。如果選取「以收件者的身分執行排程」,排定的查詢會套用存取權篩選器 users.state = 'California',並將篩選後的結果傳送給使用者 A。結果只會顯示加州的資料列。

這個選項會考量建立排程的使用者權限,以及新增至「電子郵件收件者」文字欄位的電子郵件地址類型。
在某些情況下,「以收件者身分執行排程」選項無法使用:
- 非管理員新增他人的電子郵件地址
- Looker 管理員新增已停用使用者的電子郵件地址時
- Looker 管理員新增的電子郵件地址不屬於 Looker 使用者 (Looker 帳戶的收件者旁會顯示 Looker 圖示)

- 如果電子郵件是在選取「以收件者身分執行排程」選項「之前」新增,系統會自動停用該選項。如果從收件者清單中刪除該電子郵件地址,則可再次使用。
- 如果是在選取「以收件者身分執行排程」選項後才新增電子郵件地址,系統會顯示錯誤訊息,並自動從「電子郵件收件者」欄位中移除該電子郵件地址。「以收件者的身分執行排程」選項會保持啟用狀態。
在特殊情況下,如果使用者列為已啟用「以收件者身分執行排程」的排程收件者,且該使用者的帳戶已停用,則排程在下次執行時將無法傳送給該停用使用者。如果該使用者的帳戶遭到刪除,整個排程就會無法傳送給任何收件者。Looker 管理員或具備 see_schedules 權限的使用者,可在「管理」面板的「排程器記錄」頁面診斷這項失敗。
加入連結
如果 Looker 管理員將 Looker 執行個體的電子郵件資料政策設為「傳送連結和資料」,排程器就會顯示「加入連結」選項。勾選這個選項後,透過電子郵件傳送資料時,內文會附上返回 Looker 的連結,傳送 Look 圖表和探索時會顯示「查看完整報表」,傳送資訊主頁時則會顯示「查看完整資訊主頁」。
只要按一下該連結,電子郵件收件者就能進一步查看 Looker 執行個體中的資料。收件者必須登入 Looker,並具備傳送內容所依據模型的存取權限,才能在 Looker 中查看該內容。如要將這個連結從資料傳送電子郵件中移除,請取消勾選「加入連結」核取方塊。
格式選項
如果傳送時不使用「圖表」格式,則有其他傳送選項,分別是「套用圖表選項」和「格式化資料值」。
套用圖表選項
這個選項不適用於以圖表格式傳送的 Look 或探索。
選取「套用圖表選項」,傳送的資料就會類似表格圖表。系統會套用「繪圖」、「序列」和「格式設定」選單中,為圖表設定的下列任一設定:
取消選取「套用圖表選項」,Looker 就會按照 Look 的「資料」部分或資訊主頁圖塊的「從這裡探索」視窗中顯示的資料傳送。即使未選取「套用視覺化選項」,JSON - 標籤也會使用 label 欄位。
已設定格式的資料值
您可以設定資料格式:
- 如果希望資料更接近 Looker 的「探索」體驗,請選取「格式化資料值」,但請注意,部分功能 (例如連結) 並非所有檔案類型都支援。
- 如果不想套用任何特殊的查詢結果格式 (例如將較長的數字無條件進位,或是加入 Looker 開發人員可能設定好的特殊字元),請取消選取「格式化資料值」。如果資料會匯入其他工具並進行處理,通常建議取消勾選這個選項。
資料表解析度
以圖表格式將內容傳送至電子郵件時,您可以使用「表格解析度」下拉式選單,自訂圖表寬度。可用的寬度選項如下:
- 一般:800 像素
- 寬:1680 像素
如果選擇「寬」,且圖表寬度超過電子郵件用戶端設定的限制,電子郵件收件者可能需要水平捲動,才能看到完整圖表。
時區
根據預設,Looker 會使用與帳戶相關聯的時區,判斷何時傳送資料。如果帳戶沒有關聯的時區,Looker 會使用應用程式時區。如要指定其他時區,請選取「使用自訂時區」。所選時區不會影響 Look 圖表或資訊主頁中的資料,只會影響傳送時間。
測試傳送
按一下「傳送測試」按鈕,即可將一次性測試傳送至指定目的地。「立即測試」選項不會考量部分「進階選項」設定,但會遵循所選篩選條件。
儲存上傳
排程工具底部會顯示傳送設定摘要。
如要一次性傳送,請在設定完傳送選項後,按一下「傳送」按鈕,立即將內容傳送至指定目的地。
如果是週期性傳送,請在完成傳送選項設定後,按一下「全部儲存」按鈕,儲存時間表並關閉視窗。系統會根據你的放送設定放送內容。重新開啟排程器後,左側面板會顯示已儲存的時間表。您可以選擇複製或刪除時間表,只要按一下「複製」或「刪除」圖示即可。
儲存的時間表也會顯示在使用者個人資料的「您建立的時間表」頁面,以及「管理」面板的「時間表」和「時間表記錄」頁面。詳情請參閱本頁的「查看推送作業」一節。
查看遞交狀況
您可以查看自己建立的排程,如果具備適當權限,還能查看 Looker 執行個體的所有排程。
查看您建立的配送
如要查看已建立的所有排程清單,請按一下使用者個人資料圖示,然後選取「排程」,前往「您建立的排程」頁面。如要進一步瞭解如何查看及管理已建立的排程,請參閱「查看排定的資料傳送作業」頁面。
查看其他使用者建立的傳送作業
如果 Looker 管理員已授予查看「排程」和「排程記錄」管理頁面的權限,您就能查看整個 Looker 執行個體的所有排程清單。但無法編輯或刪除這些排程。
注意事項
有時,排定的電子郵件可能無法送達一或多位收件者。如果基礎模型發生錯誤、收件者無法存取資料,或發生算繪問題或頁面錯誤,就可能發生這種情況。
請注意下列內容上傳限制:
- 如果貴公司已在 Looker 的「管理」部分設定自己的電子郵件設定,Looker 管理員必須確認設定正確無誤,且電子郵件服務供應商運作正常。外部 SMTP 伺服器可能有自己的每日或每封郵件收件者上限。
- 視「限制」設定而定,資料傳送上限為 5,000 列,或電子郵件附件檔案大小上限為 15 MB,內嵌內容電子郵件則為 20 MB。如果電子郵件的列數或資料量超過這些限制,系統就不會傳送。
- 雖然 Looker 並未硬性規定電子郵件傳送作業可指定的收件者人數上限,但如果您將傳送作業設為「以收件者身分執行」,系統就會為每位收件者觸發個別查詢。這項負載可能會嚴重影響資料庫效能,因此不建議用於大型收件者名單。建議您盡可能使用電子郵件群組或別名。
- 如果電子郵件未在預期時間傳送,但最終仍送達,可能是因為與其他 Looker 工作競爭。這些工作可能包括其他已排定傳送時間的電子郵件、多人同時探索資料,或正在建立永久衍生資料表。如果發生這種情況,請洽詢 Looker 管理員,瞭解是否有其他工作同時執行。
- 如果特定電子郵件持續從通訊群組清單中消失,可能是因為使用者取消訂閱了該已排定傳送時間的電子郵件。如果您使用群組電子郵件別名傳送郵件給多位使用者,這項規定可能會造成困擾,因為任何收件者都可以取消訂閱整個電子郵件別名。如要進一步瞭解取消訂閱,請參閱這篇 Looker 社群貼文:監控排程器取消訂閱事件。
如果無法將資料傳送至 SFTP 伺服器,請考量下列可能原因:
Looker 嘗試傳送至 SFTP 伺服器時,即使因網路設定問題 (例如目的地伺服器上的 IP 許可清單不正確,或 Looker 執行個體上的傳出通訊埠關閉) 而無法傳送,傳送作業仍可能在排程面板和記錄中標示為已完成。即使發生這些錯誤,排程記錄仍可能顯示「
Success」狀態,因此如果您懷疑有傳送失敗的情況,請務必檢查目的地 SFTP 伺服器記錄。Looker 會儲存 SFTP 伺服器的 SFTP 指紋。如果 SFTP 提交作業發生錯誤,可能是 SFTP 指紋無效。如遇這種情況,請與 Looker 管理員聯絡。
發生
Net::SSH::Exception. message: could not settle on host_key algorithm錯誤的原因,是舊版 Looker (Looker 26.2 之前版本) 提供的主機金鑰演算法,與目標 SFTP 伺服器 (例如 Red Hat 9 或 Azure Blob 儲存體 SFTP) 嚴格執行的現代安全演算法不相容。如果收到這則錯誤訊息,請將 Looker 升級至 26.2 以上版本,支援新式 SHA-2 演算法 (例如ecdsa-sha2-nistp256、rsa-sha2-256和rsa-sha2-512),即可解決問題。或者,您也可以設定目標 SFTP 伺服器,允許至少一個目前 Looker 版本支援的主機金鑰或加密演算法。Looker 升級至 26.2.14 以上版本後,如果透過 SFTP 傳送資料,或執行個體連線至 Azure Blob Storage SFTP 等主機服務或透過 Proxy 連線,可能會發生
OpenSSL::Cipher::CipherError. Error: authentication tag already generated by cipher錯誤。這項錯誤是由密碼協商期間已知的 JRuby 問題所造成。如要解決這項錯誤,請將目的地 SFTP 伺服器允許的加密演算法 (加密) 限制為aes256-ctr。舉例來說,編輯 SFTP 伺服器的sshd_config檔案,新增或限制Ciphers指令:Ciphers aes256-ctr。將資料傳送至 SFTP 伺服器時,如果收到
Java::JavaLang::NullPointerExceptions錯誤,可能是因為 JRuby 錯誤,導致無法使用橢圓曲線 (EC) 演算法或主機金鑰,從 Looker 連線至 SFTP 目的地。為避免將資料傳送至 SFTP 目的地時發生問題,請勿在~/.ssh/config或/etc/ssh_config檔案中使用 EC 演算法,或將 EC 主機金鑰儲存在 Looker 主機的~/.ssh中。如果 Looker 無法在 SFTP 伺服器上正確建構目的地路徑,就會發生
Net::SFTP::StatusException (2, 'no such file')錯誤。常見原因包括「Address」欄位使用相對路徑而非絕對路徑、「Address」欄位缺少結尾斜線 (/),或 Look、資訊主頁或排程名稱包含空格或特殊字元 (例如/),導致路徑建構失敗。如要解決這項錯誤,請按照下列步驟操作:- 使用絕對路徑:登入 SFTP 伺服器,執行
pwd擷取完整絕對路徑,然後在排程的「Address」欄位中輸入這個值,並確保結尾為斜線 (/)。 - 移除特殊字元:從 Look 圖表、資訊主頁和排程名稱中移除正斜線 (
/)。 - 使用機器友善的名稱:重新命名排程,改用底線代替空格 (例如
Report_Name)。
- 使用絕對路徑:登入 SFTP 伺服器,執行
如果 Looker 和遠端 SFTP 伺服器無法就雙方支援的金鑰交換 (KEX) 演算法達成共識,通常是因為其中一方使用已淘汰的演算法,就會發生
Net::SSH::Exception. Error: could not settle on kex algorithm錯誤。如要解決這項錯誤,請查看 SFTP 伺服器支援的金鑰交換演算法,並確認這些演算法與 Looker 支援的 KEX 演算法 (例如ecdh-sha2-nistp256、ecdh-sha2-nistp384或ecdh-sha2-nistp521) 一致。如果排定的 SFTP 傳送作業失敗,並顯示錯誤
Net::SSH::Exception: could not settle on encryption_client algorithm,表示 SFTP 伺服器和 Looker 無法就共用加密密碼達成共識。Looker 已停止支援較舊、安全性較低的加密演算法,例如 CBC (例如aes256-cbc和3des-cbc)。如要解決這項錯誤,請將這則錯誤訊息提供給 SFTP 伺服器管理員,並要求他們更新伺服器的sshd_config檔案,以便支援至少一種與 Looker 相容的加密和金鑰交換演算法。