dependência_remota

Uso

remote_dependency: public_project {
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
 "
Hierarquia
remote_dependency
Valor padrão
Nenhuma

Aceita
  • Um subparâmetro url que inclui o URL do repositório Git
  • Um subparâmetro ref que especifica uma ramificação do Git, uma tag de lançamento do Git ou o SHA de uma confirmação no repositório Git
  • Um subparâmetro override_constant, que é usado para substituir o valor de uma constante importada de outro projeto.

Definição

O parâmetro remote_dependency fornece os detalhes de um repositório Git externo que contém um projeto LookML com arquivos que você quer usar nesse projeto. É possível incluir várias instruções remote_dependency no arquivo de manifesto para importar vários projetos.

O parâmetro remote_dependency é incluído no arquivo de manifesto do projeto. Caso seu projeto não tenha um, crie um arquivo de manifesto.

O parâmetro remote_dependency recebe um nome, que pode ser o que você quiser. Esse nome é o que é usado nas instruções include para fazer referência aos arquivos importados em projetos LookML. O nome também é usado como o nome da pasta na pasta imported_projects do ambiente de desenvolvimento integrado do Looker.

Além disso, o parâmetro remote_dependency tem os seguintes subparâmetros:

url

O subparâmetro url especifica o endereço do repositório Git externo. Use o URL principal do repositório. Por exemplo, usando HTTPS:

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

Ou use SSH:

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

ref

O subparâmetro ref especifica uma ramificação do Git, uma tag de lançamento do Git ou um SHA de confirmação do repositório Git do projeto remoto que o Looker precisa trazer para seu projeto do Looker:

  • Ramificação do Git: especifique uma ramificação do Git se quiser que o Looker detecte automaticamente novas confirmações para ela no projeto remoto. Para mais informações, consulte a página de documentação Importar arquivos de outros projetos.
  • Tag de lançamento do Git: você pode especificar uma tag de lançamento do Git se quiser que o Looker detecte automaticamente novas confirmações para essa tag no projeto remoto. Para mais informações, consulte a página de documentação Importar arquivos de outros projetos.
  • SHA de confirmação do Git: especifique um SHA de confirmação se quiser ter um controle de versão estático para que as alterações no projeto importado não sejam refletidas automaticamente no projeto. Normalmente, essa seria a confirmação mais recente, mas não é obrigatória. É possível encontrar SHAs de confirmação em qualquer lugar em que você possa navegar no histórico de confirmações. Os provedores de serviços Git geralmente deixam o SHA claramente visível e legível. Essa é uma boa opção para o Looker Blocks.

Veja um exemplo de dependência remota que especifica um SHA de confirmação do projeto Git remoto:

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

Veja um exemplo de dependência remota que especifica a ramificação mestre no projeto Git remoto:

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

Seja qual for o tipo de ref especificado, quando você adicionar um remote_dependency ao seu projeto e validar seu LookML, o ambiente de desenvolvimento integrado exibirá o botão Update Dependencies. Clique no botão para exibir os arquivos do projeto remoto. Se esse for o primeiro projeto adicionado ao projeto, a atualização das dependências também solicitará que o Looker crie um arquivo de bloqueio de manifesto. O Looker usa o arquivo de bloqueio do manifesto para rastrear a versão dos projetos remotos. Consulte a seção Detectar automaticamente novas versões de um projeto remoto da página de documentação Como importar arquivos de outros projetos para mais informações.

override_constant

O parâmetro override_constant permite substituir o valor de uma constante definida em um projeto importado.

O parâmetro override_constant também pode ser usado com o parâmetro local_dependency para a importação de projetos locais.

Ao importar arquivos de um projeto para outro, é possível substituir os valores de constantes definidos no arquivo de manifesto do projeto importado. Quando você substitui o valor de uma constante, os arquivos importados que fazem referência a essa constante usarão o novo valor fornecido no projeto de importação.

Quando o parâmetro export é definido como override_required ou override_optional para uma constante definida no projeto importado, o subparâmetro override_constant de local_dependency pode ser usado para fornecer um novo valor para essa constante. Por exemplo, suponha que você tenha uma connection definida no arquivo de manifesto do projeto importado:


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

Neste exemplo, como o parâmetro export está definido como override_required, o valor precisa ser substituído no arquivo de manifesto do projeto de importação:


project_name: "importing_project"

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

Consulte a página de documentação Importar arquivos de outros projetos para ver mais informações e outro exemplo de substituição de constantes na importação de projetos.

Exemplo

Em um arquivo de manifesto, adicione o repositório Git "Google GA 360" como origem para importar arquivos de:

project_name: "thelook"

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