Looker Embed SDK 代码库中包含示例代码和 Embed SDK 简单演示。由于 Looker 注重安全性，因此该演示需要一些设置。演示还需要您的 Looker 嵌入密钥。嵌入密钥会授予对您的所有数据的访问权限，因此请注意以下事项：
- 请勿与您不希望对其实例拥有完整访问权限的任何人共享密钥。
- 如果您已在其他上下文中使用密钥，请勿重置密钥。
- 请勿将代码设置为将密钥存储在网络浏览器中。
第 1 步：在 Looker 实例中启用嵌入功能
如需了解详情，请参阅签名嵌入文档页面。
- 在您的 Looker 实例上，依次前往管理 > 平台嵌入。此操作需要管理员权限。
- 默认情况下，演示服务器在
http://localhost:8080运行。通过将该地址添加到嵌入式网域许可名单，您可以启用演示，使其能够接收来自 Looker 的消息。 - 开启嵌入身份验证。
- 要查看您的嵌入密钥，您必须对其进行重置。将密钥复制到安全的位置。
第 2 步：为您的 Looker 实例自定义演示设置
向服务器提供您的嵌入密钥。您可以通过以下几种方式实现此目的：
- 在 shell 环境中将其设置为
LOOKER_EMBED_SECRET。 - 在 sdk 目录的根目录下创建一个名为
.env的文件。在该文件中添加一行代码：LOOKER_EMBED_SECRET="YourLookerSecret"
通过以下任一方式向服务器提供 Looker 实例主机地址：
- 在 shell 环境中将其设置为
LOOKER_EMBED_HOST。 - 将
LOOKER_EMBED_HOST="yourinstance.looker.com:yourport"添加到.env文件中。
修改 demo/demo_config.ts 文件，使其适合要嵌入的页面。
// The address of your Looker instance. Required.
export const lookerHost = 'self-signed.looker.com:9999'
// A dashboard that the user can see. Set to 0 to disable dashboard.
export const dashboardId = 1
// A Look that the user can see. Set to 0 to disable look.
export const lookId = 1
修改 demo/demo_user.json 文件，使其适合要嵌入的用户类型。
{
// External embed user ID. IDs are not shared with regular users. Required
"external_user_id": "user1",
// First and last name. Optional
"first_name": "Pat",
"last_name": "Embed",
// Duration before session expires, in seconds. Required.
"session_length": 3600,
// Enforce logging in with these permissions. Recommended.
"force_logout_login": true,
// External embed group ID. Optional.
"external_group_id": "group1",
// Looker Group IDs. Optional
"group_ids": [],
// Permissions. See documentation for details. Required.
// Can any combination of:
// access_data
// see_looks
// see_user_dashboards
// see_lookml_dashboards
// explore
// create_table_calculations
// download_with_limit
// download_without_limit
// see_drill_overlay
// see_sql
// save_content
// embed_browse_spaces
// schedule_look_emails
// send_to_sftp
// send_to_s3
// send_outgoing_webhook
// schedule_external_look_emails
"permissions": [
"access_data",
"see_looks",
"see_user_dashboards",
"explore"
"save_content",
"embed_browse_spaces"
],
// Model access permissions. Required.
"models": ["powered_by", "thelook"],
// User attributes. Optional.
"user_attributes": { "locale": "en_US" },
}
第 3 步：构建并运行演示
节点服务器
- 运行：
npm install - 运行：
npm start
服务器将输出运行所用的主机和端口。如果不同于 http://localhost:8080，您需要将其添加到嵌入式网域许可名单中。
Python 服务器
- 运行：
npm install - 运行：
npm run python
服务器将输出运行所用的主机和端口。
您可能需要使用 pip install six 来安装 Python 2/3 兼容性层。