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 parametro secondario url che include l'URL del repository Git
  • Un parametro secondario ref che specifica un ramo Git, un tag di release Git o la SHA di un commit nel repository Git
  • Un parametro secondario 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 va inserito 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. Questo nome viene utilizzato 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 parametro secondario 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 parametro secondario 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:

  • Ramo Git: puoi specificare un ramo Git se vuoi che Looker rilevi automaticamente i nuovi commit per quel ramo dal progetto remoto. Per saperne di più, consulta la pagina di documentazione Importare file da altri progetti.
  • Tag di rilascio Git: puoi specificare un tag di rilascio Git se vuoi che Looker rilevi automaticamente i nuovi commit per quel tag dal progetto remoto. Per saperne di più, consulta la pagina di documentazione Importare file da altri progetti.
  • SHA del commit Git: puoi specificare un SHA del commit se vuoi utilizzare il controllo della versione statico, in modo che le modifiche al progetto importato non vengano automaticamente riportate nel tuo progetto. In genere, si tratta del commit più recente, ma non è obbligatorio. Puoi trovare gli SHA dei commit ovunque tu possa sfogliare la cronologia dei commit. I fornitori di servizi Git di solito rendono l'SHA chiaramente visibile e copiabile. Questa è una buona opzione per i blocchi di Looker.

Ecco 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"
  }

Ecco un esempio di dipendenza remota che specifica il ramo 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 il codice LookML, l'IDE visualizza il pulsante Aggiorna dipendenze. Fai clic sul pulsante per importare i file del progetto remoto. Se questo è il primo progetto remoto che hai aggiunto al tuo progetto, l'aggiornamento delle dipendenze chiederà anche a Looker di creare un file di blocco del manifest. Looker utilizza il file di blocco del manifest per monitorare la versione dei progetti remoti. Per ulteriori informazioni, consulta la sezione Rilevamento automatico di nuove versioni di un progetto remoto della pagina della documentazione Importazione di file da altri progetti.

override_constant

Il parametro override_constant ti 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 saperne di più e per un altro esempio di override delle costanti nell'importazione di progetti, consulta la pagina della documentazione Importazione di 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"
}