Git 命令参考

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

在您为项目配置 Git 之前,Git 操作面板不可用。

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

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

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

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

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