Uso
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
constante :
Jerarquía
remote_dependency |
Valor predeterminado
NingunaAcepta
|
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ámetrolocal_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"
}