dipendenza_remota

Utilizzo

remote_dependency: public_project {
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcacsedc400f668fd8147f1"
Gerarchia
remote_dependency
Valore predefinito
Nessuna

Accetta
  • Un sottoparametro url che include l'URL del repository Git
  • Un sottoparametro ref che specifica un ramo Git, un tag di rilascio Git o l'SHA di un commit nel repository Git
  • Un sottoparametro override_constant, che viene 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 i 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 tuo progetto. Se il tuo progetto non ne ha uno, puoi creare un file manifest.

Il parametro remote_dependency assegna un nome, che può essere quello che preferisci. 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, con HTTPS:

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

Oppure tramite SSH:

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

ref

Il sottoparametro ref specifica un ramo Git, un tag di rilascio Git o un SHA del commit del repository Git del progetto remoto che Looker dovrebbe inserire nel progetto Looker:

  • Ramo Git: puoi specificare un ramo Git se vuoi che Looker rilevi automaticamente i nuovi commit per il ramo dal progetto remoto. Per saperne di più, consulta la pagina della documentazione Importazione di 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 della documentazione Importazione di file da altri progetti.
  • Impegno SHA del commit: puoi specificare un SHA del commit se vuoi avere un controllo delle versioni statico, in modo che le modifiche nel progetto importato non vengano riportate automaticamente nel progetto. Si tratta, in genere, dell'impegno più recente, ma non è obbligatorio. Puoi trovare gli SHA del commit in qualsiasi punto puoi sfogliare la cronologia del commit. I provider di servizi Git di solito rendono l'SHA chiaramente visibile e copiabile. Questa è una buona opzione per Looker Blocks.

Di seguito è riportato un esempio di dipendenza remota che specifica un commit SHA dal 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 ramo master sul progetto Git remoto:

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

Indipendentemente dal tipo di ref specificato, quando aggiungi un remote_dependency al progetto e convalidi il tuo LookML, l'IDE mostrerà il pulsante Update Dependencies. Fai clic sul pulsante per visualizzare i file del progetto remoto. Se si tratta del primo progetto remoto che hai aggiunto al progetto, l'aggiornamento delle dipendenze chiederà anche a Looker di creare un file di blocco manifest. Looker utilizza il file del blocco manifest per tenere traccia della versione dei progetti remoti. Per ulteriori informazioni, consulta la sezione Rilevamento automatico di nuove versioni di un progetto remoto nella pagina della documentazione Importazione di file da altri progetti.

override_constant

Il parametro override_constant consente di ignorare 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 dei progetti locali.

Quando importi file da un progetto a un altro, puoi sostituire i valori delle costanti definiti 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, è possibile usare il sottoparametro override_constant di local_dependency per fornire un nuovo valore per quella costante. Ad esempio, supponi di avere definito una costante connection 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, consulta la pagina della documentazione Importazione di file da altri progetti e un altro esempio di sostituzioni delle costanti nell'importazione dei 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"
}