通过操作中心分享数据

除了向 Looker 的内置目标提供内容之外，您还可以使用操作（也称为集成），通过操作中心服务器向与 Looker 集成的第三方服务传送内容。

通过操作中心服务器提供的操作与数据操作不同，后者由 action LookML 参数定义。

本页面将逐步介绍构建自定义操作的选项，您可以请求将这些操作添加到 Looker Action Hub 或添加到自己的私有操作中心服务器。本页面还介绍了如何启动本地操作中心服务器来测试您的自定义操作或运行专用操作中心服务器。

要开始使用操作，您可以执行以下任一操作：

• 使用 Looker 操作中心提供的 Looker 现有操作。
• 构建自定义操作并将其发布到 Looker 操作中心，以供公众使用。
• 构建自定义操作并将其发布到专用操作中心服务器，以供私人使用。

将操作添加到操作中心后，Looker 管理员可以启用该操作，以便向这些服务提供 Looker 内容。

如果您想通过 Looker Action Hub 使用 Looker 的集成，也可以托管多个操作中心，同时托管你自己的不公开操作或自定义操作。每个操作中心的操作都会显示在管理面板的操作页面上。

Looker 操作中心

Looker 托管并提供 Looker Action Hub，这是一个无状态服务器，可以实现 Looker 的 Action API 并公开热门操作。用户使用操作发送的任何数据都将在 Looker Action Hub 服务器上临时处理，而不是在 Looker 实例中进行处理。

Looker 已与多种服务集成。请参阅管理设置 - 操作文档页面，了解如何启用这些现有服务。

Looker 操作中心要求

如需使用 Looker 集成，Looker 操作中心必须能够与 Looker 实例进行通信，并满足这些要求。在从 Looker Action Hub 启用 Looker 集成时，客户托管的实例的管理员可能需要考虑其他因素，尤其是支持流式传输结果或使用 OAuth 的集成。

Looker 操作中心必须能够通过以下方式发送和接收 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 操作中心必须向 Looker 实例发出请求，以获取支持流式传输结果或使用 OAuth 的操作。

流式传输操作可让操作使用提供所有结果的查询。启用 OAuth 的操作通过 OAuth 2.0 流程使用按用户进行身份验证。OAuth 操作必须在其源 Looker 实例中存储用户凭据，因为 Looker 操作中心是无状态的多租户，并且不会存储任何类型的用户专用凭据。

从 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 操作中心。因此，Looker 操作中心需要能够将 <host_looker_url> 解析为 IP 地址，并向 Looker 实例所在的网络发出请求。

Looker 操作中心具有始终要发出的静态出站 IP 地址：35.153.89.114、104.196.138.163 和 35.169.42.87。由 Looker 托管的实例的管理员如果启用了 IP 许可名单，则必须添加这些 IP 地址，才能使用支持流式传输的结果或使用 OAuth 的任何操作。

客户托管实例的注意事项

如需使用 Looker 集成，Looker 操作中心必须能够与 Looker 实例进行通信，并满足这些要求。由于各种原因，对于客户托管的 Looker 实例，这并不总是如此。如果 Looker 操作中心与 Looker 实例之间无法双向通信，则 Looker 操作中心可能会出现意外行为或不良行为，例如挂起查询或不可用的操作。

为了解决 Looker Action Hub 无法与 Looker 实例进行通信的潜在问题，Looker 管理员可以实施以下某种解决方案。适当的解决方案或解决方案组合将取决于 Looker 实例的架构：

• 如果客户托管的实例不可由 Looker 操作中心解决（即，Looker 操作中心无法接收来自 Looker 实例的请求），Looker 管理员可以咨询其 Looker 客户经理，以启用 public_host_url 许可功能。该许可功能会显示 --public-host-url 启动选项，可让管理员指定不同于实例 <host_looker_url> 的可解析 <public_host_url> 主机名。public_host_url 会替换某些特定 Looker Action Hub 回调网址的主机名，并通过以 public_host_url 作为可公开解析的名称的反向代理来路由这些回调网址。此反向代理仅接受来自 Looker 操作中心的静态出站 IP 地址的请求；使用此方法的 Looker 管理员必须向许可名单中添加 Looker 操作中心向 Looker 实例发出请求的出站 IP 地址：35.153.89.114、104.196.138.163 和 35.169.42.87。

• 如果客户托管的实例网址可由 Looker 实例解析，但 Looker 操作中心无法向 Looker 实例发送请求，则用户可能无法配置或使用支持流式传输结果或使用 OAuth 的操作。如需解决此问题，Looker 管理员必须向许可名单中添加 Looker 操作中心向 Looker 实例发出请求的出站 IP 地址：35.153.89.114、104.196.138.163 和 35.169.42.87。

• 如果上述解决方案都不适用于 Looker 实例架构，Looker 管理员可以为所有操作或支持流式传输结果或使用 OAuth 的操作部署客户托管的操作中心。

• 如需部署客户托管的操作中心，您必须确保 JAR 文件托管在公共服务器上，以便 Looker 操作中心能够与其通信。不过，Looker 不推荐此解决方案。

客户托管的 Looker 实例上可能无法使用 OAuth 和流式传输操作的原因另一个原因是，该实例使用了由证书授权机构 (CA) 颁发的此列表以外的 SSL 证书。

构建自定义操作

本部分介绍了使用 Looker Action Hub 源代码编写和测试自定义操作的步骤。如需查看功能代码示例，请检查 GitHub 中 looker-open-source/actions 代码库中的现有操作。

您可以通过以下方式创建自定义操作：

1. 设置开发代码库
2. 编写你的操作
3. 测试你的 Action
4. 在 Looker Action Hub 或您自己的私有操作中心服务器上发布并启用您的操作

与任何操作一样，您可能需要先使用特定参数配置 LookML 模型，然后才能使用该操作提供数据。

设置开发代码库

Looker 操作中心是一个用 TypeScript 编写的 Node.js 服务器，它是基于现代 JavaScript 的一个小型层，可添加类型信息来帮助捕获编程错误。如果您熟悉 JavaScript，那么您应该会熟悉大多数 TypeScript 语言。

运行 Looker Action Hub 需要以下软件：

• Node.js
• Node Version Manager（NVM - 选择正确的 Node.js 版本）
• Yarn（用于管理依赖项）

安装所需的软件后，您就可以设置开发环境了。以下示例使用了 Git。

1. 在本地克隆 looker-open-source/actions 代码库：

   git clone [e-mail]:looker-open-source/actions.git
   

2. 在 actions/src/actions 目录中创建一个包含您的操作名称的目录。例如：

   mkdir actions/src/actions/my_action
   

3. 开始将您的目录填充到执行操作所需的文件。如需查看文件结构示例，请参阅操作 GitHub 代码库。

Looker 还建议您添加：

• 用于说明您执行身份验证的目的和方式的 README 文件
• 显示在 Looker 操作中心（或 Looker 实例上的私有操作中心）和 Looker 数据投放窗口中的 PNG 图标
• 您想要针对操作代码运行的测试所用的文件，这与测试 Action 不同

编写操作

Looker Action Hub 服务器的设计要求是，它仍完全是无状态的，因此不允许在操作应用或服务中存储任何信息。必须在操作文件的请求调用中提供执行该操作所需的任何信息。

操作文件的确切内容因服务、操作的类型或级别以及需要指定的数据或可视化格式而异。此操作也可针对 OAuth 2.0 授权流程进行配置。

操作文件基于 /execute API 方法。每当用户在 Looker 中执行操作时，系统都会向 Looker API 请求传递一个 DataActionRequest。DataActionRequest 包含执行操作所需的所有数据和元数据。此外，您还可以使用 /form 方法在用户执行操作之前收集额外信息。当用户选择将该操作作为数据传送的目的地时，您在 /form 中指定的字段将显示在发送或计划弹出式窗口中。

如果使用 Looker Action API，这些参数的格式可能会有所不同。

编写操作文件时，请在操作定义中至少添加以下标记为必需的参数：

参数	必需	说明	数据类型
name	是	操作的唯一名称。它在 Looker 操作中心的所有操作中应该是唯一的。	字符串
url	是	此操作的 /execute 端点的绝对网址。	字符串
label	是	简单易懂的标签。	字符串
supportedActionTypes	是	操作支持的操作类型列表。有效值为 "cell"、"query" 和 "dashboard"。	字符串
formURL	否	此操作的 /form 端点的绝对网址。	字符串
description	否	操作的说明。	字符串
params	否	操作的 parameters 数组。为每个参数添加字符串格式的名称、标签和说明。这些字段显示在管理面板的操作启用页面上。要管理用户向操作目标提供数据的方式，您可以指定用户已定义值的用户属性。	parameters
supportedFormats	否	操作支持的数据格式列表。有效值为 "txt"、"csv"、"inline_json"、"json"、"json_detail", "json_detail_lite_stream", "xlsx", "html", "wysiwyg_pdf", "assembled_pdf", and "wysiwyg_png".	字符串
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	否	操作将出现在管理面板的操作中心列表中的最低 Looker 版本。	字符串

Looker 操作中心操作的示例位于 GitHub 上，以供参考。

支持的操作类型

Looker 支持三种操作（如操作的 supportedActionTypes 参数中指定）：查询、单元格和信息中心。

• 查询级操作：这项操作用于发送整个查询。例如，细分操作就是查询级别的操作。
• 单元格级操作：单元格级操作可发送数据表格中的单个特定单元格的值。此操作类型与数据操作不同，后者可以使用 action 参数为维度或测量单位定义操作。 为了从表格中的特定单元格发送信息，Looker 使用标记将操作映射到相应的单元格。操作需要指定其在 requiredFields 中支持的代码。如需映射操作和字段，LookML 中的字段需要使用 LookML tags 参数指定它们映射到的标记。 例如，Twilio 消息操作使用 phone 标记，以便 LookML 开发者控制 Twilio 操作会显示哪些电话号码字段。
• 信息中心级操作：信息中心级操作支持发送信息中心的图片。 例如，SendGrid 操作会通过电子邮件发送信息中心图片。

为自定义操作添加用户属性

对于自定义操作，您可以在操作文件的 params 参数中添加用户属性。如果需要此参数，则除了在 send_to_integration 权限之外，每个用户都必须在其用户帐号或他们所属的用户群组中定义此属性的值，这样才能看到在发送或安排内容时将该操作作为目的地选项。

如需向操作中添加用户属性，请执行以下操作：

1. Looker 管理员可能需要创建与 user_attribute_param 对应的用户属性（如果尚不存在）。
2. 针对需要向操作目标提供内容的用户或用户群组，为用户属性定义有效值。（这些用户还必须具有 send_to_integration 权限。）
3. 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 表示用户必须定义一个非 null 且有效的用户属性，用户才能看到数据；sensitive: true 表示用户属性已加密，一旦输入，就不会显示在 Looker 界面中。您可以指定多个用户属性子参数。

1. 将更新部署到操作中心服务器。
   • 如果您要添加新操作，Looker 管理员需要点击管理面板中操作页面上相应操作旁边的启用按钮，以启用该操作。
   • 如果您要更新现有操作，请点击刷新按钮刷新操作列表。接下来，点击设置按钮。
2. 在操作设置/启用页面上，Looker 管理员必须配置操作的表单字段，以便从用户属性中提取信息，方法是点击相应字段右侧的用户属性图标 ，然后选择所需的用户属性。

单元格级操作中的 requiredField 参数

对于单元格级别的操作，您可以配置模型的 LookML 字段，通过在操作文件的 requiredFields 参数中指定操作支持的标记，将数据发送到该操作目标。

参数	必需	说明	数据类型
tag	否	如果存在，则与具有此标记的字段匹配。	字符串
any_tag	否	如果存在，它将取代 tag 并匹配具有任何所提供的标记的字段。	字符串
all_tags	否	如果存在，它将取代 tag，并匹配具有所提供的所有标记的字段。	字符串

支持的数据格式

DataActionRequest 类用于定义操作可以使用的数据传输格式。对于查询级操作，请求将包含一个可以采用多种格式的附件。操作可以指定一个或多个 supportedFormats，也可以通过指定所有可能的格式让用户选择格式。对于单元格级别的操作，相应单元格的值会显示在 DataActionRequest 上。

为 OAuth 配置操作

对于已启用 IP 许可名单功能或者无法满足 Looker Action Hub 要求的 Looker 实例，无法从 Looker Action Hub 配置启用了 OAuth 的操作。如需详细了解如何为 OAuth 配置操作，请参阅为使用 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 应包含 form_field，其类型为 oauth_link，它会转到操作的 /oauth 端点。state_url 应进行加密并作为返回的 state 参数保存在返回的 oauth_url 中。例如：

{
        "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 操作中心。

使用操作中心重定向 URI 保存状态

在 /oauth 端点中，系统还会创建操作中心的 redirect_uri 并将其传递给该操作的 oauthUrl(...) 方法。此 redirect_uri 的格式为 /actions/src/actions/my_maction/oauth_redirect，如果身份验证返回了结果，则使用端点。

此端点将调用 oauthFetchInfo(...) 方法，该方法应由 OauthAction 方法实现，用于提取必要的信息并尝试接收或保存从身份验证服务器收到的任何状态或 auth。

state 会解密加密的 state_url，并将其用于将 state 发送回 Looker。当用户下次向该操作发出请求时，新保存的状态将发送到 Looker 操作中心。

将操作文件添加到 Looker Action Hub 代码库

编写操作文件后，在 Looker Action Hub 代码库中：

1. 将操作文件（例如 my_action.ts）添加到 actions/src/actions/index.ts。

   import "./my_action/my_action.ts"
   

2. 添加您在编写操作时使用的任何 Node.js 软件包要求。例如：

   yarn add aws-sdk
   yarn add express
   

3. 安装 Looker Action Hub 服务器的 Node.js 依赖项。

   yarn install
   

4. 运行您编写的任何测试。

yarn test

测试 Action

如需进行全面测试，您可以通过托管专用操作中心服务器来尝试对 Looker 实例执行操作。此服务器需要通过有效的 SSL 证书连接到公共互联网，并且必须能够向 Looker 发起和接收连接或者从其接收 HTTPS 请求。为此，您可以使用 Heroku 等云端平台（如以下示例所示），也可以使用满足上述要求的任何平台。

设置本地操作中心服务器

在此示例中，我们将执行在 looker-open-source/actions/src/actions GitHub 代码库中开发的操作，并将代码提交到新的 Git 分支。我们建议您使用分支开发功能，以便轻松跟踪代码；如果需要，您还可以通过 Looker 轻松创建 PR。

1. 首先，请创建您的分支，然后暂存并提交您的工作。例如：

   git checkout -b my-branch-name
   git add file-names
   git commit -m commit-message
   

2. 在此示例中，如需将分支推送到 Heroku，请在命令行中用 Heroku 作为远程选项配置 Git 代码库：

   heroku login
   heroku create
   git push heroku
   

3. Heroku 会返回托管操作中心的公开网址，供您使用。访问网址或运行 heroku logs，确认操作中心正在运行。如果您忘记了公开网址，可以在命令行中运行以下命令：

   heroku info -s | grep web_url
   

   Heroku 将返回您的公开网址。例如：https://my-heroku-action-server-1234.herokuapp.com

4. 在命令行中，设置你的操作中心基准网址：

   heroku config:set ACTION_HUB_BASE_URL="https://my-heroku-action-server-1234.herokuapp.com"
   

5. 设置您的 Action Hub 标签：

   heroku config:set ACTION_HUB_LABEL="Your Action Hub"
   

6. Looker 使用授权令牌连接到操作中心。在命令行中生成令牌：

   heroku run yarn generate-api-key
   

   如果您使用的不是 Heroku（如以下示例中所示），请改用：

   yarn generate-api-key
   

   Heroku 会返回您的授权令牌。例如：Authorization: Token token="abcdefg123456789"

7. 使用该密钥设置您的操作中心密钥：

   heroku config:set ACTION_HUB_SECRET="abcdefg123456789"
   

   客户托管的部署可能需要配置此处未记录的其他环境变量。

8. 转到管理 > 操作，在本地 Looker 实例中添加操作。

   • 在操作列表底部，点击添加操作中心。
   • 输入 Action Hub 网址，您也可以选择输入 Secret Key。
   • 在 Looker 的管理菜单的操作列表中找到您的操作。
   • 点击启用。

如果您的操作需要从 Looker 传递特定类型的数据，请务必配置任何模型以包含相应的 tags 参数。

现在，您可以测试您的操作了！

测试信息中心级和查询级操作

在您的 Looker 实例中，根据需要使用标记配置 LookML 模型。创建并保存外观。在已保存的 Look 中，点击右上角的菜单，然后选择 Send（将您的操作作为目的地）。如果您有表单以供发送，Looker 将在已发送窗口中呈现该表单。

点击发送测试以发送数据。操作状态会显示在管理面板的调度程序历史记录中。如果操作遇到错误，相应操作会显示在管理面板中，并且 Looker 会向发送操作的用户发送一封包含错误消息的电子邮件。

测试单元格级操作

使用适当的代码设置 LookML 字段。在您的 Looker 实例中，运行包含该字段的查询。在数据表格中找到该字段。点击单元格中的 ...，然后从下拉菜单中选择发送。如果您收到错误消息，则需要修正这些错误后对数据表进行全面刷新。

• 如果您的 Action 已投放并且没有任何错误，您可以发布 Action 了！
• 如果您想继续以非公开方式托管您的操作，可以发布到您的私有操作中心。
• 如果您要发布操作以供所有 Looker 客户使用，请参阅向 Looker 操作中心发布部分。

发布并启用自定义操作

自定义操作有两种发布方式：

• 发布到 Looker 操作中心：此操作会将操作提供给所有使用 Looker 的用户。
• 发布到私有操作中心服务器：此操作会使您的操作仅在 Looker 实例上使用。

操作发布后，您可以从管理面板的操作页面启用该操作。

发布到 Looker 操作中心

这是最简单的方法，适用于您想向使用 Looker 的任何用户采取的任何操作。

你的 Action 经过测试后，你可以向 GitHub 中的 looker-open-source/actions 代码库提交 PR。

1. 输入以下命令：

   git push <your fork> <your development branch>
   

2. 以 looker-open-source/actions 代码库为目标创建拉取请求。

3. 填写 Looker Marketplace 和 Action Hub 提交表单。如需详细了解表单要求，请参阅向 Looker Marketplace 提交内容。

   Looker 会审核你的操作代码。我们保留拒绝您的 PR 的权利，但可以帮您解决遇到的任何问题，并提供改进建议。然后，我们将代码合并到 looker-open-source/actions 代码库中，并将其部署到 actions.looker.com。部署后，代码将可供所有 Looker 客户使用。

4. 在您的 Looker 实例中启用此操作，使其显示为数据传送选项。

发布到私有操作中心服务器

如果您有对公司或用例不公开的自定义操作，则不得将操作添加到 looker-open-source/actions 代码库。而应使用您在测试操作所用的同一 Node.js 框架来创建私有操作中心。

您可以在自己的基础架构上设置内部操作中心服务器，也可以使用云端应用平台（比如我们的示例 Heroku）。不要忘记在部署之前将 Looker Action Hub 分支到您的专用操作中心服务器。

配置与操作搭配使用的 LookML 模型

对于 Looker 操作中心提供的自定义操作和操作，您必须使用 LookML 模型中的 tags 参数标识相关数据字段。

管理面板中的操作页面会提供该服务所需的代码（如果有）的相关信息。

例如，Zapier 集成声明它可以与任何查询搭配使用。无需向 LookML 模型中的字段添加 tags 参数。

不过，Twilio Send Message 服务会向电话号码列表发送消息。它需要一个查询，其中包含电话号码字段，并使用 tags 参数来识别查询中的哪个字段包含电话号码。您可以通过在 LookML 中为该字段指定 tags: ["phone"] 来标识电话号码字段。电话号码字段的 LookML 可能如下所示：

dimension: phone {
  tags: ["phone"]
  type: string
  sql: ${TABLE}.phone ;;
}

请务必使用 tags 参数确定 LookML 模型中的所有必填字段，以便用户可以使用该服务发送数据。

通过操作提供数据

系统可以通过多种方式提供数据，具体取决于操作的级别。操作适用于字段、查询或信息中心级别，并且可以在一个或多个级别进行操作。管理面板的操作页面上列出的每项操作都说明了其使用方式。您可以：

• 提供数据单元格
• 提供整个信息中心或查询（通过“查看”或“探索”）

传递移动数据网络

在管理面板的操作页面上，系统会通过说明“操作可用于字段”或是（在集成服务列表中的“可在字段中使用”列）中显示“字段级操作”。

字段级操作旨在向指定的服务传递数据单元格。它们的工作原理与数据操作类似，不同之处在于它们是通过 Looker Action API 提供。您必须使用集成服务列表中的此操作的代码列中的相关信息标记相关字段，来配置 LookML 模型，而不是为维度或衡量定义 action LookML 参数。

在 LookML 模型中启用服务和标记字段后，您可以：

1. 查看要在 Look、dashboard 或 Discover 中传送的数据。如果服务指定“可将操作与带有标记字段的查询搭配使用...”，则您的查询或信息中心的某个图块必须包含一个或多个带有任何必需标记的字段。

2. “查看”、“信息中心”或“探索”中每个单元格内的标记字段都会包含一个以省略号 (...) 表示的下拉列表。点击省略号可查看可通过该链接执行的操作。

3. 在操作部分，点击要接收行数据的服务。

提供信息中心或查询数据

在管理面板的操作页面上，系统会通过说明“操作可用于具有字段标记的查询...”等操作或“操作可用于任何查询”来描述查询级操作。根据集成服务列表中的可以发送或安排列，您可以传递每一行（在 Look 或 Discover 中）。查询级操作旨在将来自“探索”或“查找”的完整查询结果传递到指定服务。

信息中心级操作在管理面板的操作页面上显示，并带有“操作可用于任何信息中心”说明。根据集成服务列表中的可以发送或安排列，您可以提供信息中心。信息中心级操作旨在向特定服务提供信息中心。

启用相应服务，并根据需要标记 LookML 模型中的字段。

如需提交 Look 或 Discover，请参阅 Delivering Look and Discovers 文档页面。

如需提供信息中心，请参阅交付旧版信息中心以及安排和发送信息中心文档页面。