Uso
remote_dependency: public_project { url: "https://github.com/llooker/google_ga360" ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1" override_constant: constant_name { value: "string" } }
|
Jerarquía
remote_dependency |
Valor predeterminado
Ninguno
Acepta
|
Definición
El parámetro remote_dependency proporciona los detalles de un repositorio de Git externo que contiene un proyecto de LookML con archivos que deseas usar en este proyecto. Puedes incluir varias instrucciones remote_dependency en el archivo de manifiesto para importar varios proyectos.
El parámetro remote_dependency va 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 el que desees. Este es el nombre que usas en las instrucciones include para hacer referencia a los archivos importados en los 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 parámetro secundario 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, con SSH:
url: "git@github.com:llooker/google_ga360.git"
ref
El subparámetro ref especifica una rama de Git, una etiqueta de versión de Git o un SHA de confirmación del repositorio de Git del proyecto remoto que Looker debe incorporar a tu proyecto de Looker:
- Rama de Git: Puedes especificar una rama de Git si deseas que Looker detecte automáticamente las nuevas confirmaciones de esa rama desde el proyecto remoto. Para obtener más información, consulta la página de documentación Cómo importar archivos de otros proyectos.
- Etiqueta de versión de Git: Puedes especificar una etiqueta de versión de Git si quieres que Looker detecte automáticamente las nuevas confirmaciones para esa etiqueta desde el proyecto remoto. Para obtener más información, consulta la página de documentación Cómo importar 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, este sería la confirmación más reciente, pero no es obligatorio que lo sea. Puedes encontrar los SHA de confirmación en cualquier lugar donde puedas explorar el historial de confirmaciones. Por lo general, los proveedores de servicios de Git hacen que el SHA sea claramente visible y se pueda copiar. Esta es una buena opción para los bloques de Looker.
A continuación, se muestra un ejemplo de una dependencia remota que especifica un SHA de confirmación del proyecto Git remoto:
remote_dependency: ga_360 {
url: "https://github.com/llooker/google_ga360"
ref: "f99720c597f524d0756b8194990342efa11b3813"
}
A continuación, se muestra un ejemplo de una dependencia remota que especifica la rama principal en el proyecto Git remoto:
remote_dependency: ga_360 {
url: "https://github.com/llooker/google_ga360"
ref: "main"
}
Independientemente del tipo de ref que especifiques, cuando agregues un remote_dependency a tu proyecto y valides tu LookML, el IDE mostrará el botón Update Dependencies. Haz clic en el botón para importar los archivos del proyecto remoto. Si este es el primer proyecto remoto que agregaste a tu proyecto, la actualización de las dependencias también le indicará a Looker que 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 Cómo detectar automáticamente versiones nuevas de un proyecto remoto en la página de documentación Cómo importar archivos de 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_constanttambién se puede usar con el parámetrolocal_dependencypara 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 proporcionado 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, se puede usar el subparámetro override_constant de local_dependency para proporcionar un valor nuevo para esa constante. Por ejemplo, supongamos que tienes una constante connection definida en el archivo de manifiesto del proyecto importado:
constant: connection {
value: "imported_project_connection"
export: override_required
}
En este ejemplo, dado que el parámetro export está establecido en override_required, su valor se debe anular 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 de cómo anular constantes en proyectos de importación.
Ejemplo
En un archivo de manifiesto, agrega el repositorio de Git "Google GA 360" como una fuente desde la que se importarán archivos:
project_name: "thelook"
remote_dependency: ga_360 {
url: "https://github.com/llooker/google_ga360"
ref: "6a95679c92efa56243c17fb4d66c820cd4a8db03"
}