dépendance_à_distance

Utilisation

remote_dependency : public_project {
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
:
:
constante :
Hiérarchie
remote_dependency
Valeur par défaut
Aucun

Acceptation
  • Un sous-paramètre url incluant l'URL du dépôt Git
  • Un sous-paramètre ref qui spécifie une branche Git, un tag de version Git ou l'algorithme SHA d'un commit dans le dépôt Git
  • Un sous-paramètre override_constant qui permet de remplacer la valeur d'une constante importée depuis un autre projet

Définition

Le paramètre remote_dependency fournit les détails d'un dépôt Git externe contenant un projet LookML qui comporte des fichiers que vous souhaitez utiliser dans ce projet. Vous pouvez inclure plusieurs instructions remote_dependency dans le fichier manifeste pour importer plusieurs projets.

Le paramètre remote_dependency figure dans le fichier manifeste de votre projet. Si votre projet n'en possède pas, vous pouvez créer un fichier manifeste.

Le paramètre remote_dependency doit avoir un nom. Vous pouvez choisir ce que vous voulez. Il s'agit du nom que vous utilisez dans les instructions include pour référencer les fichiers importés dans les projets LookML. Il est également utilisé comme nom de dossier dans le dossier imported_projects de l'IDE Looker.

De plus, le paramètre remote_dependency comporte les sous-paramètres suivants:

url

Le sous-paramètre url spécifie l'adresse du dépôt Git externe. Utilisez l'URL principale du dépôt. Par exemple, si vous utilisez HTTPS:

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

Ou en SSH:

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

ref

Le sous-paramètre ref spécifie une branche Git, un tag de version Git ou un commit SHA du dépôt Git du projet distant que Looker doit importer dans votre projet Looker:

  • Branche Git: vous pouvez spécifier une branche Git si vous souhaitez que Looker détecte automatiquement les nouveaux commits de cette branche à partir du projet distant. Pour en savoir plus, consultez la page Importer des fichiers à partir d'autres projets.
  • Tag de publication Git: vous pouvez spécifier un tag de version Git si vous souhaitez que Looker détecte automatiquement les nouveaux commits de ce tag à partir du projet distant. Pour en savoir plus, consultez la page Importer des fichiers à partir d'autres projets.
  • Commit Git SHA: vous pouvez spécifier un commit SHA si vous souhaitez disposer d'une gestion des versions statique afin que les modifications apportées au projet importé ne soient pas automatiquement répercutées dans votre projet. En général, il s'agit du commit le plus récent, mais ce n'est pas obligatoire. Vous pouvez trouver des SHA de commit partout où vous pouvez consulter l'historique des commits. Les fournisseurs de services Git font généralement en sorte que le certificat SHA soit clairement visible et modifiable. C'est une bonne option pour les blocs Looker.

Voici un exemple de dépendance à distance qui spécifie un commit SHA à partir du projet Git distant:

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

Voici un exemple de dépendance distante spécifiant la branche principale du projet Git distant:

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

Quel que soit le type de ref spécifié, lorsque vous ajoutez un remote_dependency à votre projet et que vous validez votre LookML, l'IDE affiche le bouton Update Dependencies (Mettre à jour les dépendances). Cliquez sur le bouton pour importer les fichiers distants du projet. S'il s'agit du premier projet distant que vous avez ajouté à votre projet, la mise à jour des dépendances invitera aussi Looker à créer un fichier de verrouillage de manifeste. Looker utilise le fichier de verrouillage du fichier manifeste pour suivre la version du ou des projets distants. Pour en savoir plus, consultez la section Détecter automatiquement les nouvelles versions d'un projet distant de la page Importer des fichiers à partir d'autres projets.

override_constant

Le paramètre override_constant vous permet de remplacer la valeur d'une constante définie dans un projet importé.

Vous pouvez également utiliser le paramètre override_constant avec le paramètre local_dependency pour importer un projet local.

Lorsque vous importez des fichiers d'un projet dans un autre, vous pouvez remplacer les valeurs des constantes définies dans le fichier manifeste du projet importé. Lorsque vous remplacez la valeur d'une constante, les fichiers importés qui font référence à cette constante utilisent la nouvelle valeur fournie dans le projet d'importation.

Lorsque le paramètre export est défini sur override_required ou override_optional pour une constante définie dans le projet importé, vous pouvez utiliser le sous-paramètre override_constant de local_dependency pour fournir une nouvelle valeur à cette constante. Par exemple, supposons que vous ayez une constante connection définie dans le fichier manifeste du projet importé:


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

Dans cet exemple, comme le paramètre export est défini sur override_required, sa valeur doit être remplacée dans le fichier manifeste du projet d'importation:


project_name: "importing_project"

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

Consultez la page Importer des fichiers à partir d'autres projets pour en savoir plus et voir un autre exemple de remplacement de constantes dans l'importation de projets.

Exemple

Dans un fichier manifeste, ajoutez le dépôt Git "Google GA 360" en tant que source à partir de laquelle importer des fichiers:

project_name: "thelook"

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