setting-up-looker-project

设置 Looker 项目

创建新的 Looker 项目，并使用本地裸 Git 仓库进行配置。

前提条件

• 必须安装并完成身份验证的 Looker CLI（参见 installing-looker-cli 和 authenticating-looker-cli 技能）。

操作说明

1. 切换到开发工作区

切换到“dev”工作区（创建或修改项目配置时必须这样做）。建议将此操作与项目操作串联，以确保始终处于 dev 工作区：

looker-cli session update dev

2. 创建项目

将项目名称负载写入 /tmp/project_create.json：

{
  "name": "{project_id}"
}

使用项目导入命令创建 Looker 项目（与 session update dev 串联）：

looker-cli session update dev && looker-cli project import /tmp/project_create.json

说明

为 {project_id} 使用唯一且适合 URL 的名称（例如， my_new_project）。

3. 配置本地裸 Git 仓库

将 Git 配置负载写入 /tmp/project_git.json：

{
  "git_service_name": "bare"
}

配置项目以使用本地裸 Git 仓库：

looker-cli session update dev && looker-cli project update {project_id} /tmp/project_git.json

说明

这会在 Looker 服务上设置本地 Git 仓库，无需使用外部 Git 托管服务， 非常适合快速上手。

4. 验证项目设置

获取项目详情，验证 Git 是否已正确配置：

looker-cli project cat {project_id}

确保输出表明 uses_git 为 true，且 git_remote_url 不为 null（其格式类似 ../../bare_models/{project_id}.git）。

说明

更新 Git 后，Looker 服务上的更改可能需要稍作时间才能生效。如果 project cat 命令失败（例如，返回 400 错误），请等待几秒后重试。