error_remoto

Uso

remote_dependency: public_project {
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
constante :
Jerarquía
remote_dependency
Valor predeterminado
Ninguna

Acepta
  • Un subparámetro url que incluye la URL del repositorio de Git
  • Un subparámetro ref que especifica una rama de Git, una etiqueta de lanzamiento de Git o el SHA de una confirmación en el repositorio de Git
  • Un subparámetro override_constant, que se usa para anular el valor de una constante importada de otro proyecto

Definición

El parámetro remote_dependency proporciona los detalles de un repositorio de Git externo que contiene un proyecto de LookML que tiene archivos que deseas usar en este proyecto. Puedes incluir varias declaraciones remote_dependency en el archivo de manifiesto para importar varios proyectos.

El parámetro remote_dependency se incluye en el archivo de manifiesto de tu proyecto. Si tu proyecto no tiene uno, puedes crear un archivo de manifiesto.

El parámetro remote_dependency toma un nombre, que puede ser cualquiera que desees. Este nombre es lo que usas en las declaraciones include para hacer referencia a los archivos importados en proyectos de LookML. El nombre también se usa como el nombre de la carpeta en la carpeta imported_projects del IDE de Looker.

Además, el parámetro remote_dependency tiene los siguientes subparámetros:

url

El subparámetro url especifica la dirección del repositorio externo de Git. Usa la URL principal del repositorio. Por ejemplo, con HTTPS:

url: "https://github.com/llooker/google_ga360"

O bien, mediante SSH:

url: "git@github.com:llooker/google_ga360.git"

ref

El subparámetro ref especifica una rama de Git, una etiqueta de lanzamiento de Git o una SHA de confirmación del repositorio de Git del proyecto remoto que Looker debe traer a tu proyecto de Looker:

  • Rama de Git: Puedes especificar una rama de Git si deseas que Looker detecte automáticamente las confirmaciones nuevas para esa rama desde el proyecto remoto. Para obtener más información, consulta la página de documentación Importa archivos de otros proyectos.
  • Etiqueta de lanzamiento de Git: Puedes especificar una etiqueta de lanzamiento de Git si deseas que Looker detecte automáticamente nuevas confirmaciones de esa etiqueta desde el proyecto remoto. Para obtener más información, consulta la página de documentación Importa archivos de otros proyectos.
  • SHA de confirmación de Git: puedes especificar un SHA de confirmación si deseas tener un control de versiones estático, de modo que los cambios en el proyecto importado no se reflejen automáticamente en tu proyecto. Por lo general, esta es la confirmación más reciente, pero no es obligatorio que lo sea. Para conocer los SHA de confirmación, revisa el historial de confirmaciones. Los proveedores de servicios de Git suelen hacer que el SHA se vea y copie con claridad. Esta es una buena opción para los bloques de Looker.

A continuación, se muestra un ejemplo de dependencia remota que especifica un SHA de confirmación del proyecto remoto de Git:

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "f99720c597f524d0756b8194990342efa11b3813"
  }

A continuación, se muestra un ejemplo de dependencia remota que especifica la rama principal en el proyecto remoto de Git:

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "master"
}

Sin importar el tipo de ref que especifiques, cuando agregues un remote_dependency a tu proyecto y valides el LookML, el IDE mostrará el botón Update Dependencies. Haz clic en el botón para incorporar los archivos del proyecto remoto. Si este es el primer proyecto remoto que agregaste a tu proyecto, la actualización de dependencias también hará que Looker cree un archivo de bloqueo de manifiesto. Looker usa el archivo de bloqueo del manifiesto para hacer un seguimiento de la versión de los proyectos remotos. Consulta la sección Detección automática de versiones nuevas de un proyecto remoto de la página de documentación Importa archivos desde otros proyectos para obtener más información.

override_constant

El parámetro override_constant te permite anular el valor de una constante que se definió en un proyecto importado.

El parámetro override_constant también se puede usar con el parámetro local_dependency para la importación de proyectos locales.

Cuando importas archivos de un proyecto a otro, puedes anular los valores de las constantes definidas en el archivo de manifiesto del proyecto importado. Cuando anulas el valor de una constante, los archivos importados que hacen referencia a esa constante usarán el valor nuevo que se proporcionó en el proyecto de importación.

Cuando el parámetro export se establece en override_required o override_optional para una constante definida en el proyecto importado, el subparámetro override_constant de local_dependency se puede usar a fin de proporcionar un valor nuevo para esa constante. Por ejemplo, supongamos que tienes una connection constante definida en el archivo de manifiesto del proyecto importado:


constant: connection {
  value: "imported_project_connection"
  export: override_required
}

En este ejemplo, debido a que el parámetro export se estableció en override_required, su valor debe anularse en el archivo de manifiesto del proyecto de importación:


project_name: "importing_project"

remote_dependency: public_project {
  url: "https://github.com/llooker/project"
  ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: connection {
    value: "importing_project_connection"
  }
}

Consulta la página de documentación Importa archivos de otros proyectos para obtener más información y otro ejemplo sobre cómo anular constantes en la importación de proyectos.

Ejemplo

En un archivo de manifiesto, agregue el repositorio de Git "Google GA 360" como fuente desde la cual importar archivos:

project_name: "thelook"

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "6a95679c92efa56243c17fb4d66c820cd4a8db03"
}