Git 命令参考

您可以通过 Looker IDE 右上角的按钮或者从左侧导航菜单中选择 Git Actions 按钮来使用 Git 命令。

您必须先针对 Git 配置项目,然后才能使用 Git 操作面板。

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

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

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

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

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