Utilizzo
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcacsedc400f668fd8147f1"
Gerarchia
remote_dependency |
Valore predefinito
NessunaAccetta
|
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 parametrolocal_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"
}