除了將內容提交至 Looker 內建的目的地,您也可以使用動作 (也稱為整合),將內容提交至透過動作中樞伺服器與 Looker 整合的第三方服務。
本頁面將逐步說明建構自訂動作的選項,您可以要求將這些動作新增至 Looker 動作中樞,或新增至您自己的私人動作中樞伺服器。本頁也說明如何啟動本機動作中樞伺服器,以便測試自訂動作或執行私人動作中樞伺服器。
如要開始使用動作,可以採取以下做法:
- 使用 Looker 現有的動作,可在 Looker Action Hub 中找到。
- 建立並發布自訂動作至 Looker Action Hub,供大眾使用。
- 建構並發布自訂動作至私人動作中心伺服器,供私人使用。
將動作新增至動作中心後,Looker 管理員就能啟用該動作,用於將 Looker 內容提供給這些服務。
如果您想透過 Looker Action Hub 使用 Looker 整合功能,並代管自己的私人或自訂動作,也可以設定多個 Action Hub。每個行動中心的動作會顯示在「管理」面板的「動作」頁面中。
Looker Action Hub
Looker 會代管並提供 Looker Action Hub,這是一個無狀態伺服器,可實作 Looker 的 Action API,並公開熱門動作。使用者透過動作傳送的所有資料,會暫時在 Looker Action Hub 伺服器上處理,而非在 Looker 執行個體中處理。
Looker 已與多項服務整合。如要瞭解如何啟用這些現有服務,請參閱「管理員設定 - 動作」說明文件。
Looker Action Hub 需求
Looker Action Hub 必須能夠以下列方式傳送及接收 API 要求:
- 從 Looker 執行個體到 Looker Action Hub 網路
- 從 Looker 使用者的瀏覽器到 Looker Action Hub 網路
- 從 Looker Action Hub 網路傳送至 Looker 執行個體
如果 Looker 部署無法支援這些要求,或是 Looker 執行個體已啟用 IP 許可清單功能,建議您考慮設定本機動作中樞伺服器,以便提供私人 Looker 整合或自訂動作。客戶代管執行個體的管理員也可以專門為 OAuth 和串流動作部署本地動作伺服器。
Looker 執行個體傳送至 Looker Action Hub 網路的要求
對 actions.looker.com
提出的要求會解析為動態 IP 位址。Looker 執行個體的傳出要求必須能夠到達下列端點:
actions.looker.com/
actions.looker.com/actions/<name>/execute
actions.looker.com/actions/<name>/form
其中 name
是動作的程式名稱。
Looker 使用者的瀏覽器向 Looker Action Hub 網路發出的請求
Looker 使用者的瀏覽器必須能夠向下列 Looker Action Hub 端點提出要求 (適用於 OAuth):
actions.looker.com/actions/<name>/oauth
其中 name
是動作的程式名稱。
從 Looker Action Hub 網路傳送至 Looker 執行個體的要求
Looker Action Hub 必須向 Looker 執行個體提出要求,才能執行支援串流結果或使用 OAuth 的動作。
串流動作可讓動作使用可提供「所有結果」的查詢。啟用 OAuth 的動作會透過 OAuth 2.0 流程使用個別使用者驗證。OAuth 動作必須在原始 Looker 例項中儲存使用者憑證,因為 Looker Action Hub 是無狀態和多租戶的,因此不會儲存任何類型的使用者專屬憑證。
Looker Action Hub 傳送至 Looker 執行個體的要求格式如下:
GET <host_looker_url>/downloads/<random_40_char_token>
POST <host_looker_url>/action_hub_state/<random_40_char_token>
這些網址會在 Looker 執行個體中當場產生,然後傳送至 Looker Action Hub。因此,Looker 動作中樞需要能夠將 <host_looker_url>
解析為 IP 位址,並向 Looker 執行個體所在網路提出要求。
Looker Action Hub 有靜態出口 IP 位址,要求一律會來自 35.153.89.114
、104.196.138.163
和 35.169.42.87
。已啟用 IP 許可清單的 Looker 託管執行個體管理員必須加入這些 IP 位址,才能使用支援串流結果或使用 OAuth 的任何動作。
客戶代管執行個體的注意事項
如要使用 Looker 整合,Looker Action Hub 必須能夠與 Looker 執行個體通訊,並符合 Looker Action Hub 相關規定。但客戶代管的 Looker 執行個體不一定能做到這點,原因有很多。如果 Looker Action Hub 和 Looker 例項之間無法進行雙向通訊,Looker Action Hub 可能會出現非預期或不理想的行為,例如掛起查詢或無法執行的動作。
為解決 Looker Action Hub 無法與 Looker 執行個體通訊的潛在問題,Looker 管理員可以實作本頁稍後列出的一項解決方案。適當的解決方案或解決方案組合取決於 Looker 執行個體的架構:
如果 Looker Action Hub 無法解析客戶代管的執行個體,也就是 Looker Action Hub 無法接收 Looker 執行個體傳送的要求,Looker 管理員可以聯絡 Google Cloud 銷售專員,啟用
public_host_url
授權功能。這個授權功能會顯示--public-host-url
啟動選項,讓管理員指定可解析的<public_host_url>
主機名稱,這個名稱必須與執行個體<host_looker_url>
不同。public_host_url
會覆寫部分 Looker Action Hub 回呼網址的主機名稱,並透過將public_host_url
做為公開可解析名稱的反向 Proxy,將這些回呼網址導向至該 Proxy。這個反向 Proxy 只會接受 Looker Action Hub 靜態出口 IP 位址的請求;使用這項方法的 Looker 管理員必須將 Looker Action Hub 向 Looker 執行個體提出請求的出口 IP 位址:35.153.89.114
、104.196.138.163
和35.169.42.87
加入許可清單。如果 Looker 執行個體可解析客戶代管的執行個體網址,但 Looker Action Hub 無法將要求傳送至 Looker 執行個體,使用者可能無法設定或使用支援串流結果或使用 OAuth 的動作。如要解決這個問題,Looker 管理員必須將 Looker Action Hub 向 Looker 執行個體提出要求的出口 IP 位址加入許可清單:
35.153.89.114
、104.196.138.163
和35.169.42.87
。如果上述兩種解決方案都不適合 Looker 執行個體架構,Looker 管理員可以部署由客戶代管的動作中心,用於所有動作,或只用於支援串流結果或使用 OAuth 的動作。
如要部署由客戶代管的動作中樞,您必須確保 JAR 檔案代管在公開伺服器上,以便 Looker 動作中樞與之通訊。不過,我們不建議採用這個解決方案。
此外,如果執行個體使用的 SSL 憑證是由不在根憑證清單中的憑證授權單位 (CA) 核發,則客戶代管的 Looker 執行個體可能無法使用 OAuth 和串流操作。
建構自訂動作
本節將說明使用 Looker Action Hub 原始碼編寫及測試自訂動作的步驟。如要查看功能程式碼範例,請前往 GitHub 的 looker-open-source/actions
存放區查看現有的動作。
您可以透過下列方式建立自訂動作:
如同其他動作,您可能需要使用特定參數設定 LookML 模型,才能使用該動作提交資料。
設定開發存放區
Looker Action Hub 是使用 TypeScript 編寫的 Node.js 伺服器,這是新式 JavaScript 之上的一個小層,可新增類型資訊,協助找出程式設計錯誤。如果您熟悉 JavaScript,應該會對 TypeScript 語言的大部分內容感到熟悉。
執行 Looker Action Hub 需要下列軟體:
安裝必要軟體後,即可設定開發環境。以下範例使用 Git。
在本機複製
looker-open-source/actions
存放區:git clone git@github.com:looker-open-source/actions.git
在
actions/src/actions
目錄中建立一個以動作名稱命名的目錄。例如:mkdir actions/src/actions/my_action
開始在目錄中填入執行動作所需的檔案。如需檔案結構的範例,請參閱 actions GitHub 存放區。
Looker 建議您也新增下列項目:
- README 檔案,說明動作的驗證目的和方式
- 在 Looker Action Hub (或 Looker 執行個體的私人行動中心) 和 Looker 資料提交視窗中顯示的 PNG 圖示
- 您想在動作程式碼上執行的任何測試檔案,這與測試動作不同
編寫動作
Looker Action Hub 伺服器的設計要求是完全無狀態,因此不允許在動作應用程式或服務中儲存任何資訊。執行動作所需的任何資訊,都必須在動作檔案的請求呼叫中提供。
動作檔案的確切內容會因服務、動作運作類型或層級,以及需要指定的資料或視覺化格式而異。您也可以為 OAuth 2.0 授權流程設定動作。
動作檔案是根據 /execute
API 方法建立。每次使用者在 Looker 中執行動作時,Looker API 要求都會傳遞 DataActionRequest
。DataActionRequest
包含執行動作所需的所有資料和中繼資料。您也可以使用 /form
方法,在使用者執行動作前,先向他們收集其他資訊。當使用者選取該動作做為資料傳送目的地時,您在 /form
中指定的欄位會顯示在「傳送」或「排程」彈出式視窗中。
編寫動作檔案時,請至少在動作定義中加入以下標示為「必要」的參數:
參數 | 必填 | 說明 | 資料類型 |
---|---|---|---|
name |
是 | 動作的專屬名稱。這個值在 Looker Action Hub 的所有動作中不得重複。 | 字串 |
url |
是 | 這個動作的 /execute 端點絕對網址。 |
字串 |
label |
是 | 使用者容易理解的動作標籤。 | 字串 |
supportedActionTypes |
是 | 動作支援的動作類型清單。有效值為 "cell" 、"query" 和 "dashboard" 。 |
字串 |
formURL |
否 | 這個動作的 /form 端點絕對網址。 |
字串 |
description |
否 | 動作的說明。 | 字串 |
params |
否 | 動作的 parameters 陣列。請為每個參數加上名稱、標籤和說明,並以字串格式輸入。這些欄位會顯示在「管理」面板的動作啟用頁面中。如要管理使用者如何將資料傳送至動作目的地,您可以指定使用者必須具備定義值的使用者屬性。 |
parameters |
supportedFormats |
否 | 動作支援的資料格式清單。有效值為 "txt" 、"csv" 、"inline_json" 、"json" 、"json_detail" |
字串 |
supportedFormattings |
否 | 列出動作支援的格式設定選項。有效值為 "formatted" 和 "unformatted" 。 |
字串 |
supportedVisualizationFormattings |
否 | 列出動作支援的視覺化格式選項。有效值為 "apply" 和 "noapply" 。 |
字串 |
iconName |
否 | 代表動作圖示圖片的資料 URI。 | 字串 |
requiredFields |
否 | 這個動作相容的必填欄位說明清單。如果這份清單中有多個項目,則動作需要多個欄位。 | RequiredField |
supportedDownloadSettings |
否 | 布林值,用於決定是否要傳送一次性下載網址,以便無限串流資料。該參數由 usesStreaming 參數設定,後者為 true/false 布林值。如果值為 usesStreaming = true ,則為 supportedDownloadSettings = url 。如果值為 usesStreaming = false ,則為 supportedDownloadSettings = push 。 |
布林值 |
usesOAuth |
否 | 這個布林值可判斷動作是否為 OAuth 動作。這會決定是否要為這項動作傳送一次性連結,以便為特定使用者設定 state 。 |
布林值 |
usesStreaming |
否 | 布林值,用於判斷動作是否支援串流查詢結果。請查看整合服務清單中的「使用資料串流 (是/否)」資料欄。如要透過動作串流結果,可能需要設定本機動作中樞伺服器。詳情請參閱「為使用 OAuth 或串流的動作設定本機動作中樞」最佳做法頁面。 | 布林值 |
minimumSupportedVersion |
否 | 在「管理」面板的「Action Hub」清單中,動作會顯示的 Looker 最低版本。 | 字串 |
如需 Looker Action Hub 動作的範例,請參考 GitHub。
支援的動作類型
Looker 支援三種動作,如動作的 supportedActionTypes
參數所指定:查詢、單元格和資訊主頁。
- 查詢層級動作:這是會傳送整個查詢的動作。舉例來說,「區隔動作」是查詢層級動作。
- 儲存格層級動作:儲存格層級動作會傳送資料表中單一特定儲存格的值。這類動作與資料動作不同,後者可使用
action
參數針對維度或資料表達式定義。如要傳送表格中特定儲存格的資訊,Looker 會使用標記將動作對應至對應的儲存格。動作必須在requiredFields
中指定支援哪些標記。如要對應動作和欄位,LookML 中的欄位必須使用 LookMLtags
參數指定要對應的標記。舉例來說,Twilio 訊息動作使用phone
標記,讓 LookML 開發人員可以控制 Twilio 動作會顯示在哪些電話號碼欄位。 - 資訊主頁層級動作:資訊主頁層級動作可用於傳送資訊主頁的圖片。舉例來說,SendGrid 動作會透過電子郵件傳送資訊主頁圖片。
在自訂動作中加入使用者屬性
如要新增自訂動作,您可以在動作檔案的 params
參數中新增使用者屬性。如果需要使用這個參數,則每位使用者必須在自己的使用者帳戶或所屬使用者群組中,除了具備 send_to_integration
權限之外,還必須為這個屬性定義值,才能在傳送或排程內容時,將該動作設為目的地選項。
如要為動作新增使用者屬性,請按照下列步驟操作:
- 如果
user_attribute_param
尚未存在,Looker 管理員可能需要建立對應的使用者屬性。 - 為需要將內容提交至動作目的地的使用者或使用者群組,定義有效的使用者屬性值。(這些使用者也必須具備
send_to_integration
權限)。 params
參數代表 Looker 管理員必須在「管理」面板的「動作」清單中,從動作啟用頁面設定的表單欄位。在動作檔案的params
參數中加入下列內容:
params = [{
description: "A description of the param.",
label: "A label for the param.",
name: "action_param_name",
user_attribute_name: "user_attribute_name",
required: true,
sensitive: true,
}]
其中 user_attribute_name
是使用者屬性,定義於「管理員」面板的「使用者」部分的「使用者屬性」頁面中的「名稱」欄位,required: true
表示使用者必須為該使用者屬性定義非空值和有效值,才能在傳送資料時查看該動作,sensitive: true
則表示使用者屬性已加密,且一旦輸入就不會顯示在 Looker UI 中。您可以指定多個使用者屬性子參數。
- 將更新部署至動作中樞伺服器。
- 如果您要新增動作,Looker 管理員必須在「管理」面板的「動作」頁面中,點選動作旁邊的「啟用」按鈕,才能啟用該動作。
- 如果要更新現有動作,請按一下「重新整理」按鈕,重新整理動作清單。接著,按一下「設定」按鈕。
- 在動作設定/啟用頁面中,Looker 管理員必須按一下適當欄位右側的使用者屬性圖示
,然後選取所需使用者屬性,設定動作的表單欄位,以便從使用者屬性擷取資訊。
儲存格層級動作中的 requiredField
參數
針對單元格層級動作,您可以設定模型的 LookML 欄位,在動作檔案的 requiredFields
參數中指定動作支援的代碼,以便將資料傳送至該動作目的地。
參數 | 必填 | 說明 | 資料類型 |
---|---|---|---|
tag |
否 | 如果有這個標記,則會比對含有這個標記的欄位。 | 字串 |
any_tag |
否 | 如果有這個欄位,則會取代 tag ,並比對含有任何提供標記的欄位。 |
字串 |
all_tags |
否 | 如果有這個欄位,則會取代 tag ,並比對含有所有提供代碼的欄位。 |
字串 |
支援的資料格式
DataActionRequest
類別會定義動作可使用的資料提交格式。對於查詢層級動作,要求會包含附件,而附件可採用多種格式。動作可以指定一或多個 supportedFormats
,也可以指定所有可能的格式,讓使用者選擇格式。對於儲存格層級動作,儲存格的值會顯示在 DataActionRequest
上。
設定 OAuth 動作
您可以設定動作,讓使用者透過 OAuth 驗證進入動作。雖然 Looker Action Hub 必須保持無狀態,但您可以透過 Looker Action API 的表單要求強制執行狀態。
Looker 動作 OAuth 流程
針對 Looker 動作中心中的動作,您可以擴充 OAuthAction
而非 Hub.Action
,藉此設定布林值,指出需要使用哪些 OAuth 方法,才能將使用者驗證為動作。對於每個啟用 OAuth 或狀態的動作,Looker 都會儲存個別使用者和個別動作的狀態,因此每個動作和使用者組合都會有獨立的 OAuth 事件。
建立動作的流程通常會涉及 /form
要求,後面接著 /execute
要求。針對 OAuth,/form
要求應具備方法,用於判斷使用者是否已在目標服務中完成驗證。如果使用者已通過身分驗證,動作應根據 /execute
要求的任何需求,傳回一般 /form
。如果使用者未經過驗證,這個動作會傳回連結,以便初始化 OAuth 流程。
使用 OAuth 網址儲存狀態
Looker 會將含有空白主體的 HTTP POST 要求傳送至 ActionList
端點。如果動作在定義中傳回 uses_oauth: true
,則在 Looker 的每個 /form
要求中,動作都會傳送一次性的 state_url
。state_url
是一次性專用網址,可設定使用者在特定動作的狀態。
如果使用者未透過端點進行驗證,則傳回的 /form
應包含 oauth_link
類型的 form_field
,並連往動作的 /oauth
端點。state_url
應加密,並儲存在傳回的 oauth_url
中,做為 state
參數。例如:
{
"name": "login",
"type": "oauth_link",
"label": "Log in",
"description": "OAuth Link",
"oauth_url": "ACTIONHUB_URL/actions/my_action/oauth?state=encrypted_state_url"
}
在這個範例中,/oauth
端點會將使用者重新導向至驗證伺服器。/oauth
端點會在 OAuth 動作的 oauthUrl(...)
方法中建構重新導向,如 Dropbox OauthUrl 所示。
包含加密 state_url
的 state
參數應傳遞至 Looker Action Hub。
使用動作中樞重新導向 URI 儲存狀態
在 /oauth
端點中,也會建立動作中樞的 redirect_uri
,並傳遞至動作的 oauthUrl(...)
方法。這個 redirect_uri
的格式為 /actions/src/actions/my_maction/oauth_redirect
,如果驗證程序傳回結果,就會使用這個端點。
這個端點會呼叫 oauthFetchInfo(...)
方法,而該方法應由 OauthAction
方法實作,以便擷取必要資訊,並嘗試接收或儲存從驗證伺服器收到的任何狀態或 auth
。
state
會解密已加密的 state_url
,並使用該值將 state
回傳至 Looker。下次使用者對該動作提出要求時,系統會將新儲存的狀態傳送至 Looker Action Hub。
將動作檔案新增至 Looker Action Hub 存放區
動作檔案寫入後,請在 Looker Action Hub 存放區中:
將動作檔案 (例如
my_action.ts
) 新增至actions/src/actions/index.ts
。import "./my_action/my_action.ts"
新增在撰寫動作時用到的任何 Node.js 套件需求。例如:
yarn add aws-sdk yarn add express
安裝 Looker Action Hub 伺服器的 Node.js 依附元件。
yarn install
執行您編寫的任何測試。
yarn test
測試動作
如要進行完整測試,您可以代管私人動作中心伺服器,針對 Looker 執行個體測試動作。這部伺服器必須位於公開網際網路上,並具備有效的 SSL 憑證,且必須能夠發出及接收與 Looker 之間的連線或 HTTPS 要求。為此,您可以使用 Heroku 等雲端平台,如以下範例所示。或者,您也可以使用任何符合上述需求的平台。
設定本機動作中樞伺服器
在本例中,我們會採取在 looker-open-source/actions/src/actions
GitHub 存放區中開發的動作,並將程式碼提交至新的 Git 分支。建議您使用分支來處理功能,這樣就能輕鬆追蹤程式碼,並視需要透過 Looker 輕鬆建立 PR。
如要開始使用,請建立分支版本,然後將工作納入階段並提交。例如:
git checkout -b my-branch-name git add file-names git commit -m commit-message
在本例中,如要將分支版本推送至 Heroku,請在指令列中將 Git 存放區設定為 Heroku 的遠端選項:
heroku login heroku create git push heroku
Heroku 會傳回目前代管動作中心的公開網址,供您使用。請前往該網址或執行
heroku logs
,確認動作中樞是否正在執行。如果忘記公開網址,可以在指令列中執行以下指令:heroku info -s | grep web_url
Heroku 會傳回您的公開網址。例如:
https://my-heroku-action-server-1234.herokuapp.com
在指令列中設定動作中心的基準網址:
heroku config:set ACTION_HUB_BASE_URL="https://my-heroku-action-server-1234.herokuapp.com"
設定行動中心標籤:
heroku config:set ACTION_HUB_LABEL="Your Action Hub"
Looker 會使用授權權杖連線至行動中心。在指令列中產生權杖:
heroku run yarn generate-api-key
如果您不使用 Heroku (如本範例所示),請改用以下命令:
yarn generate-api-key
Heroku 會傳回授權權杖。例如:
Authorization: Token token="abcdefg123456789"
使用密鑰設定動作中樞密鑰:
heroku config:set ACTION_HUB_SECRET="abcdefg123456789"
客戶代管部署作業可能需要設定這裡未列出的其他環境變數。
前往「管理」 >「動作」,即可在本機 Looker 執行個體上新增動作。
- 在動作清單底部,按一下「新增行動中心」。
- 輸入 Action Hub 網址,並視需要輸入密鑰。
- 在 Looker 的「管理」選單中,找出「動作」清單中的動作。
- 按一下「啟用」。
如果您的動作需要從 Looker 傳遞特定類型的資料,請務必設定任何模型,以便納入適當的 tags
參數。
您現在可以測試動作了!
測試資訊主頁層級和查詢層級動作
在 Looker 執行個體中,視需要使用代碼設定 LookML 模型。建立並儲存外觀。在已儲存的 Look 中,按一下右上方的選單,然後選取「傳送」,並將動作設為目的地。如果您有要提交的表單,Looker 會在「Sent」視窗中顯示表單。
按一下「傳送測試」即可傳送資料。動作狀態會顯示在「管理」面板的排程器記錄中。如果動作發生錯誤,系統會在「管理」面板中顯示錯誤訊息,並向傳送動作的使用者傳送含有錯誤訊息的電子郵件。
測試儲存格層級動作
設定 LookML 欄位,並加入適當的動作代碼。在 Looker 執行個體中,執行包含該欄位的查詢。在資料表格中找出欄位。按一下儲存格中的「…」,然後在下拉式選單中選取「傳送」。如果收到錯誤訊息,請先解決這些錯誤,再對資料表進行完整重新整理。
- 如果動作能順利提交且沒有任何錯誤,您就可以發布動作了!
- 如果您想私下代管動作,可以發布至私人動作中心。
- 如要將動作發布給所有 Looker 客戶使用,請參閱「發布至 Looker Action Hub」一節。
發布及啟用自訂動作
自訂動作有兩種發布選項:
- 發布至 Looker Action Hub:讓所有使用 Looker 的使用者都能使用您的動作。
- 發布至私人動作中樞伺服器:這樣做可讓動作僅在 Looker 執行個體上提供。
動作發布後,您可以在「管理」面板的「動作」頁面中啟用該動作。
發布至 Looker Action Hub
這是最簡單的方法,適用於您希望向所有 Looker 使用者提供的任何動作。
測試完成後,您可以將 PR 提交至 GitHub 中的 looker-open-source/actions
存放區。
輸入下列指令:
git push <your fork> <your development branch>
建立合併要求時,請將
looker-open-source/actions
存放區設為目標。請填寫 Looker Marketplace 和 Action Hub 提交表單。如要進一步瞭解表單規定,請參閱「將內容提交至 Looker Marketplace」。
Looker 會審查您的動作程式碼。我們保留拒絕提交的權利,但會協助您解決任何問題,並提供改善建議。接著,我們將程式碼合併至
looker-open-source/actions
存放區,並部署至actions.looker.com
。部署完成後,所有 Looker 客戶都能使用這組代碼。
發布至私人動作中心伺服器
如果您有自訂動作是公司或用途專屬,則不應將動作新增至 looker-open-source/actions
存放區。請改用用於測試動作的相同 Node.js 架構,建立私人動作中心。
您可以在自己的基礎架構中設定內部動作中樞伺服器,也可以使用雲端應用程式平台 (我們的範例使用 Heroku)。請務必在部署前將 Looker Action Hub 分支至私人 Action Hub 伺服器。
設定 LookML 模型以搭配動作使用
無論是自訂動作,還是可透過 Looker 動作中心取得的動作,您都必須在 LookML 模型中使用 tags
參數,識別相關資料欄位。「管理」面板中的「動作」頁面會提供服務所需的標記資訊 (如有)。
舉例來說,Twilio Send Message 整合功能會將訊息傳送至電話號碼清單。在「管理」面板的「動作」頁面中,整合功能會顯示「動作可用於標記為 phone
的查詢」子文。
也就是說,Twilio 傳送訊息服務需要查詢包含電話號碼欄位,並使用 tags
參數來識別查詢中哪個欄位包含電話號碼。您可以在 LookML 中指定 tags: ["phone"]
來識別電話號碼欄位。電話號碼欄位的 LookML 可能會如下所示:
dimension: phone {
tags: ["phone"]
type: string
sql: ${TABLE}.phone ;;
}
如果整合功能不需要代碼,則「管理」面板的「動作」頁面會顯示「動作可與任何查詢搭配使用」子文。
請務必使用 tags
參數,在 LookML 模型中標示任何必要欄位,方便使用者透過服務傳送資料。
後續步驟
瞭解如何將Look 或 Explore 或資訊主頁的內容提交至整合服務。