Git 命令参考

您可以通过 Looker IDE 右上角的按钮或通过左侧导航菜单中的 Git 操作按钮来访问 Git 命令。

只有在您为项目配置 Git 后,Git 操作面板才会显示。

下表显示了可能的 Git 命令。请注意,您在 Looker IDE 中看到的命令取决于您在进行更改和部署到生产环境的过程中所处的位置。IDE 仅显示适用于您当前状态的 Git 命令。

函数 说明 访问方式
提交 对 LookML 项目进行任何更改并保存后,请使用提交更改并推送按钮将这些更改提交到本地分支并推送到生产环境。如需了解详情,请参阅使用版本控制和部署文档页面。 Git Actions 面板
提交更改并推送 按钮
提交并解决冲突在合并冲突后进行更改时,系统会显示提交并解决冲突按钮。点击提交并解决冲突以提交更改并清除合并冲突。 按钮
提交历史记录 显示分支的提交列表,其中包括您从生产分支拉取到开发分支的所有提交(包括其他用户的提交)。

如果您使用的是 GitHub,并且 Git Project Settings(项目设置)已启用 GitHub Integration(GitHub 集成),则每个提交都会包含指向 GitHub 上相应提交的链接,以便您查看确切的更改。如果您的 Git Project Settings(项目设置)已启用与 GitHub 集成等同的 Git 提供程序,此功能也适用于其他 Git 提供程序。如需打开这些链接,您需要在 Git 提供商处拥有一个账号。
Git Actions 面板
配置 Git 如果您刚刚创建了一个项目,则需要为该项目配置 Git。如需了解详情,请参阅设置和测试 Git 连接文档页面。 按钮
从远程部署 对于开发者拥有只读权限的项目,从远程部署按钮会从远程生产分支部署。 按钮
部署到生产环境 提交更改后,使用部署到生产环境选项,使用开发分支中的已提交更改更新生产分支。如果您的项目配置为需要拉取请求,则此选项不可用。此外,如果您的项目启用了高级部署模式,您将不会看到部署到生产环境按钮。而是会看到合并到主分支 按钮,Git 操作面板
不解决 当项目中的一个或多个开发者或开发分支之间存在合并冲突时,系统会显示不解决按钮。Don't Resolve(不解决)按钮会将分支的当前版本(包含所有合并冲突标记)推送到远程。

只有高级 Git 用户应使用此选项,因为合并冲突标记可能会导致您的模型无法使用。
按钮
合并到主分支 如果您的项目启用了高级部署模式,则在您提交代码后,系统会显示合并到主分支按钮。系统会提示您将更改合并到主分支。将更改合并到主分支后,具有 deploy 权限的 Looker 开发者可以使用 webhookAPI 或 Looker IDE 中的部署管理器界面将更改部署到生产环境。 按钮
打开(Git 提供程序) 打开(Git 提供程序)选项会打开一个浏览器窗口,以便您在 Git 提供程序的界面上查看项目文件。 按钮
打开拉取请求 对于建议或要求提交拉取请求的项目,打开拉取请求选项会打开一个新的浏览器窗口,指向 Git 服务提供商的新拉取请求页面。然后,您可以为开发者分支创建拉取请求。

注意:在拉取请求获得批准和/或关闭之前,该分支上的所有后续提交内容都将包含在同一拉取请求中。
Git Actions 面板
拉取和合并其他更改 Pull & Merge Other Changes 按钮的功能与 Pull from (production branch) 相同,但在不同情况下会看到 Pull & Merge Other Changes 按钮:当您在分支上提交了更改但尚未部署这些更改,并且分支上还有未部署的远程提交更改时,就会看到 Pull & Merge Other Changes 按钮。在这种情况下,您需要从远程提取更改,并将其合并到您的分支中。 按钮
从主分支拉取 如果您的项目启用了高级部署模式,当主分支包含开发者分支中没有的提交时,系统会显示从主分支拉取选项。 按钮
从(生产分支)拉取 如果当前开发者分支包含未提交的更改,则无法使用从(生产分支)拉取选项。您必须先在分支上提交更改,然后才能看到从(生产分支)拉取选项。 按钮,Git 操作面板
拉取远程更改 如果其他用户已提交并推送了分支上的更改,则分支的远程版本将比您本地的分支版本更高。拉取远程更改按钮适用于您当前所在的分支,它会从远程端检索分支上所有已更改文件的最新版本,并将其同步到您的本地文件。 按钮
将分支推送到远程 如果您创建的分支在远程端不存在,则会看到将分支推送到远程按钮。Push Branch to Remote 选项会在远程端创建分支,并将本地文件中的所有已提交更改推送到远程端。请注意,这不会将您的更改部署到正式版分支。 按钮
将更改推送到远程 如果您已向当前分支提交更改,但尚未将其推送到分支的远程版本,则会看到将更改推送到远程选项。将更改推送到远程操作会应用于您当前所在的分支,将本地文件中的所有已提交更改推送到远程端并将其同步到远程端。 按钮,Git 操作面板
还原为远程 还原为远程分支选项会舍弃本地分支中的所有更改,并将本地文件同步到远程分支上的当前文件。请注意,这会产生两个影响:
  1. 舍弃尚未部署到正式版的所有已提交和未提交的更改
  2. 使用其他用户对分支所做的任何更改更新分支的本地版本
按钮
还原为“共享” 还原为共享选项会舍弃本地分支中的所有更改,并将本地文件同步到远程分支上的当前文件。请注意,这会产生两个影响:
  1. 舍弃尚未部署到正式版的所有已提交和未提交的更改
  2. 使用其他用户对分支所做的任何更改更新分支的本地版本
按钮
还原未提交的更改 如果您保存了尚未提交的更改,可以使用还原未提交的更改选项舍弃所有未提交的更改。如需了解详情,请参阅使用版本控制和部署文档页面。 按钮
运行测试 如果您的项目配置为需要通过数据测试才能部署到生产环境,那么在您将更改提交到项目后,IDE 会显示 Run Tests(运行测试)按钮。您必须先通过数据测试,然后才能将更改部署到生产环境。您还可以点击项目健康状况面板中的运行数据测试图标,手动运行测试。如需了解如何运行数据测试,请参阅使用版本控制和部署文档页面。如需了解如何在项目中设置数据测试,请参阅 test 参数文档页面。 按钮
测试 Git 连接 为项目配置 Git 后,您可以使用测试 Git 连接选项运行 Git 测试连接工具,以验证您的 Git 连接是否设置正确。如需了解详情,请参阅测试 Git 连接文档页面。 按钮,Git 操作面板
最新 如果您的本地分支与远程分支同步,您会看到已更新按钮。 按钮
更新依赖项 对于使用远程项目导入的项目,当您首次添加远程项目,或者您的项目已有导入的远程项目且 Looker 检测到该项目有可供您导入到项目中的新提交时,系统会显示更新依赖项选项。使用此选项可导入远程项目文件。如果您刚刚添加了远程项目,使用此选项还会创建一个清单锁定文件,Looker 会使用该文件跟踪远程项目的版本。如需了解详情,请参阅从其他项目导入文件文档页面的自动检测远程项目的新版本部分。 按钮,Git 操作面板
验证 LookML 如果您保存了对文件的更改,则可能会看到验证 LookML 按钮。(您是否需要验证 LookML 取决于项目的代码质量设置。)点击该按钮即可开始对模型进行 LookML 验证。如需了解详情,请参阅验证 LookML 文档页面。 按钮
查看项目 (Git 提供程序) 在 (Git 提供程序) 上查看项目选项会打开一个浏览器窗口,用于在 Git 提供程序的界面上查看项目文件。 Git Actions 面板
查看未提交的更改 如果您保存了尚未提交的更改,可以使用查看未提交的更改选项查看自上次提交以来您保存的所有更改。如需了解详情,请参阅使用版本控制和部署文档页面。 Git Actions 面板