remote_dependency

Uso

remote_dependency:  public_project {
  url:  "https://github.com/llooker/google_ga360"
  ref:  "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: constant_name {
    value: "string"
  }
}
Hierarquia
remote_dependency
Valor padrão
Nenhum

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 um commit no repositório Git.
  • Um subparâmetro override_constant, 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 do LookML com arquivos que você quer usar neste projeto. É possível incluir várias instruções remote_dependency no arquivo de manifesto para importar vários projetos.

O parâmetro remote_dependency fica no arquivo de manifesto do projeto. Se o projeto não tiver um, crie um arquivo de manifesto.

O parâmetro remote_dependency usa um nome, que pode ser qualquer coisa. Esse nome é o que você usa nas instruções include para referenciar os arquivos importados em projetos do LookML. O nome também é usado como o nome da pasta em 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 usando 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 commit 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 novos commits dessa ramificação 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 novos commits para essa tag no projeto remoto. Para mais informações, consulte a página de documentação Importar arquivos de outros projetos.
  • SHA de commit do Git: especifique um SHA de commit se quiser ter controle de versão estático para que as mudanças no projeto importado não sejam refletidas automaticamente no seu projeto. Normalmente, esse é o commit mais recente, mas não é obrigatório. Você pode encontrar SHAs de commit em qualquer lugar em que possa navegar pelo histórico de commits. Os provedores de serviços do Git geralmente tornam o SHA claramente visível e copiável. Essa é uma boa opção para os Blocos do Looker.

Este é um exemplo de dependência remota que especifica um SHA de commit do projeto Git remoto:

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

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

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

Independente do tipo de ref especificado, quando você adiciona um remote_dependency ao projeto e valida a LookML, o ambiente de desenvolvimento integrado mostra o botão Atualizar dependências. Clique no botão para trazer os arquivos do projeto remoto. Se este for o primeiro projeto remoto adicionado ao seu projeto, a atualização das dependências também vai solicitar que o Looker crie um arquivo de bloqueio de manifesto. O Looker usa o arquivo de bloqueio de manifesto para rastrear a versão dos projetos remotos. Consulte a seção Detecção automática de novas versões de um projeto remoto na página de documentação 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 importação de projetos locais.

Ao importar arquivos de um projeto para outro, é possível substituir os valores das constantes definidas no arquivo de manifesto do projeto importado. Quando você substitui o valor de uma constante, os arquivos importados que fazem referência a ela usam 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 constante 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 dele 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 mais informações e outro exemplo de substituição de constantes em projetos de importação.

Exemplo

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

project_name: "thelook"

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