remote_dependency

Utilizzo

remote_dependency:  public_project {
  url:  "https://github.com/llooker/google_ga360"
  ref:  "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: constant_name {
    value: "string"
  }
}
Gerarchia
remote_dependency
Valore predefinito
Nessuno

Accetta
  • Un sottoparametro url che include l'URL del repository Git
  • Un sottoparametro ref che specifica un branch Git, un tag di release Git o la SHA di un commit nel repository Git
  • Un sottoparametro override_constant, utilizzato per sostituire il valore di una costante importata da un altro progetto

Definizione

Il parametro remote_dependency fornisce i dettagli di un repository Git esterno contenente un progetto LookML con file che vuoi utilizzare in questo progetto. Puoi includere più istruzioni remote_dependency nel file manifest per importare più progetti.

Il parametro remote_dependency si trova nel file manifest del progetto. Se il tuo progetto non ne ha uno, puoi creare un file manifest.

Il parametro remote_dependency accetta un nome, che può essere qualsiasi cosa tu voglia. Questo nome è quello che utilizzi nelle istruzioni include per fare riferimento ai file importati nei progetti LookML. Il nome viene utilizzato anche come nome della cartella nella cartella imported_projects dell'IDE di Looker.

Inoltre, il parametro remote_dependency ha i seguenti sottoparametri:

url

Il sottoparametro url specifica l'indirizzo del repository Git esterno. Utilizza l'URL principale del repository. Ad esempio, utilizzando HTTPS:

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

Oppure utilizzando SSH:

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

ref

Il sottoparametro ref specifica un branch Git, un tag di release Git o una SHA di commit del repository Git del progetto remoto che Looker deve importare nel tuo progetto Looker:

  • Branch Git: puoi specificare un branch Git se vuoi che Looker rilevi automaticamente i nuovi commit per quel branch dal progetto remoto. Per ulteriori informazioni, consulta la pagina della documentazione Importare file da altri progetti.
  • Tag di release Git: puoi specificare un tag di release Git se vuoi che Looker rilevi automaticamente i nuovi commit per quel tag dal progetto remoto. Per ulteriori informazioni, consulta la pagina della documentazione Importare file da altri progetti.
  • SHA di commit Git: puoi specificare una SHA di commit se vuoi avere il controllo delle versioni statico, in modo che le modifiche nel progetto importato non vengano automaticamente riflesse nel tuo progetto. In genere, si tratta del commit più recente, ma non è obbligatorio. Puoi trovare le SHA di commit ovunque tu possa sfogliare la cronologia dei commit. I provider di servizi Git in genere rendono la SHA chiaramente visibile e copiabile. Questa è una buona opzione per i blocchi Looker.

Di seguito è riportato un esempio di dipendenza remota che specifica una SHA di commit del progetto Git remoto:

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

Di seguito è riportato un esempio di dipendenza remota che specifica il branch principale del progetto Git remoto:

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

Indipendentemente dal tipo di ref specificato, quando aggiungi un remote_dependency al progetto e convalidi LookML, l'IDE visualizza il pulsante Aggiorna dipendenze. Fai clic sul pulsante per importare i file del progetto remoto. Se è il primo progetto remoto che hai aggiunto al tuo progetto, l'aggiornamento delle dipendenze chiederà anche a Looker di creare un file di blocco manifest. Looker utilizza il file di blocco manifest per monitorare la versione dei progetti remoti. Per ulteriori informazioni, consulta la sezione Rilevare automaticamente le nuove versioni di un progetto remoto della pagina della documentazione Importare file da altri progetti.

override_constant

Il parametro override_constant consente di sostituire il valore di una costante definita in un progetto importato.

Il parametro override_constant può essere utilizzato anche con il parametro local_dependency per l'importazione di progetti locali.

Quando importi file da un progetto a un altro, puoi sostituire i valori delle costanti definite nel file manifest del progetto importato. Quando sostituisci il valore di una costante, i file importati che fanno riferimento a quella costante utilizzeranno il nuovo valore fornito nel progetto di importazione.

Quando il parametro export è impostato su override_required o override_optional per una costante definita nel progetto importato, il sottoparametro override_constant di local_dependency può essere utilizzato per fornire un nuovo valore per quella costante. Ad esempio, supponiamo di avere una costante connection definita nel file manifest del progetto importato:


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

In questo esempio, poiché il parametro export è impostato su override_required, il relativo valore deve essere sostituito nel file manifest del progetto di importazione:


project_name: "importing_project"

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

Per ulteriori informazioni e un altro esempio di sostituzione delle costanti nei progetti di importazione, consulta la pagina della documentazione Importare file da altri progetti.

Esempio

In un file manifest, aggiungi il repository Git "Google GA 360" come origine da cui importare i file:

project_name: "thelook"

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