local_dependency

用法

local_dependency: {
  project: "other_project"
  override_constant: constant_name {
    value:"string"
  }
}
层次结构
local_dependency
默认值

接受
  • 一个 project 子形参,接受一个字符串,用于指定另一个包含您要纳入的文件的项目的名称
  • 一个 override_constant 子形参,用于替换从其他项目导入的常量的值

定义

local_dependency 用于指定另一个 LookML 项目的名称,该项目包含您想在此项目中使用的文件。从其他项目导入文件时,您必须创建清单文件,并使用 local_dependency 参数指定要从中导入文件的项目。

您可以使用 local_dependencyproject 子参数指定要从中导入文件的单个项目的名称。如需从多个项目导入文件,您可以在清单文件中添加多个 local_dependency 语句。

常量也可以使用项目导入在项目之间传递,并且可以使用 override_constant 参数来替换导入项目中的常量值。添加 local_dependency 参数以指定其他项目后,您可以使用 include 参数添加单个文件。

当您导入项目时,Looker IDE 会自动创建 imported_projects 文件夹。本地项目和远程项目中的文件都会列在 imported_projects 文件夹中。如需了解详情,请参阅在 IDE 中使用文件夹文档页面。

示例

在清单文件中,添加项目“IMPORTED_PROJECT_1”和“IMPORTED_PROJECT_2”作为要从中导入文件的来源:

project_name: "thelook"

local_dependency: {
  project: "IMPORTED_PROJECT_1"
}

local_dependency: {
  project: "IMPORTED_PROJECT_2"
}

注意事项

使用 override_constant 替换导入的常量

override_constant 参数还可以与 remote_dependency 参数搭配使用,以实现远程项目导入。

将文件从一个项目导入到另一个项目时,您可以替换导入的项目清单文件中定义的常量的值。替换常量的值后,引用该常量的导入文件将使用导入项目中提供的新值。

如果将 export 参数设置为 override_requiredoverride_optional(针对导入的项目中定义的常量),则可以使用 local_dependencyoverride_constant 子参数为该常量提供新值。例如,假设您在导入的项目的清单文件中定义了一个常量 schema


constant: schema {
  value: "imported_project_schema"
  export: override_required
}

在此示例中,由于 export 参数设置为 override_required,因此必须在导入项目的清单文件中替换其值:


project_name: "importing_project"

local_dependency: {
  project: "imported_project"
  override_constant: schema {
    value: "importing_project_schema"
  }
}

如需了解详情以及有关在导入项目中替换常量的另一个示例,请参阅从其他项目导入文件文档。