Implantar blocos do Looker

Esta página descreve as etapas para instalar um bloco do Looker pré-criado para o Cortex Framework localizado em um repositório público do GitHub, como:

• SAP para Cortex
• Salesforce Sales Cloud (SFDC) para Cortex
• Oracle EBS para Cortex
• Salesforce Marketing Cloud (SFMC) para Cortex
• Meta para Cortex
• YouTube (com o DV360) para Cortex
• Insights conectados de produtos e mídias cruzadas para o Cortex

Para implantar o Painel do Looker para a Dun & Bradstreet, consulte Painel do Looker Studio para a Dun & Bradstreet.

Pré-requisitos

Para acessar e usar esses painéis predefinidos, você precisa fazer o seguinte:

1. Implantar o Cortex Framework: verifique se o Cortex Framework está definido e configurado com suas fontes de dados. Para mais informações, consulte Pré-requisitos do Cortex Framework para implantação.
2. Acessar o Looker:acesse o Looker e se familiarize com a plataforma.
3. Conferir os painéis disponíveis: confira os painéis predefinidos e os insights disponíveis no painel que você quer implantar. Para mais informações, consulte Blocos do Looker disponíveis.

Depois de concluir os pré-requisitos, você poderá instalar o Looker Block.

Instalação

Os blocos do Looker usam o LookML (Looker Modeling Language) para definir o modelo semântico dos painéis do Looker. Para instalar o modelo LookML que corresponde à sua fonte de dados do Cortex, use uma das seguintes opções:

• Opção A: instalar pelo Marketplace do Looker usando um URL do Git.
• Opção B: instalar bifurcando o repositório.

As seções a seguir descrevem as etapas de cada opção.

Opção A: instalar pelo Marketplace do Looker usando um URL do Git

O Marketplace do Looker é um local central no Looker para encontrar, implantar e gerenciar blocos, aplicativos, visualizações e plug-ins do Looker. Para instalar pelo Marketplace do Looker usando um URL do Git, siga estas etapas:

1. Acesse sua instância do Looker.
2. Clique no botão Marketplace na barra de menus do Looker .
3. No menu do Marketplace, selecione a opção Gerenciar.
4. Na página Gerenciar, selecione o menu Opções de três pontos .
5. Selecione o botão Install via Git URL.
6. Insira o URL e o SHA do repositório escolhido:
   • SAP para Cortex
   • Salesforce Sales Cloud (SFDC) para Cortex
   • Oracle EBS para Cortex
   • Salesforce Marketing Cloud (SFMC) para Cortex
   • Meta para Cortex
   • YouTube (com o DV360) para Cortex
   • Insights de cross media e produtos conectados para o Cortex
7. Clique em Install (Instalar).
8. Clique em "Concordar e continuar" na caixa de diálogo "Termos e Condições".
9. Insira os parâmetros obrigatórios que correspondem aos seus dados:
   • Nome da conexão
   • ID do projeto
   • Conjunto de dados de relatórios
10. Clique em Install (Instalar).

Para mais informações, consulte a documentação do Looker sobre como instalar uma ferramenta usando um URL do Git.

Opção B: instalar bifurcando o repositório

Para instalar blocos do Looker bifurcando o repositório, siga estas etapas:

1. Bifurque o repositório do GitHub:

   1. Acesse o repositório do GitHub do bloco do Looker escolhido:
      • SAP para Cortex
      • Salesforce Sales Cloud (SFDC) para Cortex
      • Oracle EBS para Cortex
      • Salesforce Marketing Cloud (SFMC) para Cortex
      • Meta para Cortex
      • YouTube (com o DV360) para Cortex
      • Insights conectados de produtos e mídias cruzadas para o Cortex
   2. Clique em Bifurcar no canto superior direito do repositório.
   3. Crie um fork com seu nome de usuário. Isso cria uma cópia do repositório na sua conta do GitHub.

2. Crie um projeto do LookML em branco:

   Observação: para versões do Looker anteriores à 24.20, consulte Criar um projeto em branco na página "Novo projeto"-
   1. Verifique se você está no modo de desenvolvimento.
   2. Selecione Projects no menu Develop.

   3. No canto superior esquerdo da página Projetos do LookML, selecione Configurar novo modelo para abrir a página Configurar um modelo.

   4. Na página Configurar um modelo, especifique as opções do modelo:

      1. Modelo: nomeie seu modelo com o mesmo nome do arquivo model.lkml no repositório. Por exemplo, nomeie o modelo como cortex-<datasource>.

         Observação: o Looker exige nomes de modelos exclusivos. Se um modelo com o nome pretendido já existir, uma mensagem de erro vai ser exibida. Garanta a exclusividade do nome do modelo para evitar falhas de instalação.

      2. Project: nomeie seu projeto. Dê o mesmo nome do modelo ou especifique um nome diferente.

      3. Conexões permitidas:especifique quais conexões de banco de dados podem ser usadas pelo modelo ou especifique que o modelo tem permissão para usar qualquer conexão atual ou futura.

   5. Clique em Salvar para salvar o projeto como Em espera.

   6. Na página Projetos do LookML, localize o novo projeto na seção Projetos pendentes.

   7. Clique em Adicionar LookML para abrir a página Novo projeto.

   8. Na página "Novo projeto", especifique as opções:

      1. Nome do projeto: já preenchido com o valor especificado na etapa anterior.
      2. Ponto de partida: selecione Projeto em branco.

   9. Selecione Criar projeto. O Looker cria o projeto e o abre no ambiente de desenvolvimento integrado do Looker.

   Para mais informações, consulte a documentação original do Looker sobre Como gerar um modelo do LookML.

3. Conectar o novo projeto LookML ao repositório bifurcado: siga as etapas na documentação do Looker, Configurar e testar uma conexão do Git.

4. Atualize os valores das constantes no arquivo manifest.lkml:

   1. Abra o arquivo manifest.lkml no repositório bifurcado no Looker.
   2. Localize a seção de constantes e atualize os valores conforme descrito na seção Parâmetros obrigatórios.

5. Confirmar e implantar as mudanças na produção. Com o projeto do Looker baseado no repositório bifurcado, você pode personalizar o LookML para atender às suas necessidades comerciais. Siga as etapas em Como levar suas mudanças para a produção.

Parâmetros obrigatórios

Esses valores obrigatórios são configurados durante o processo de instalação do Marketplace ou, se o bloco foi instalado de um repositório Git bifurcado, é necessário atualizar os valores dessas constantes no arquivo manifest.lkml do projeto.

Parâmetro	Valor	Descrição	Looker Block
Connection Name	Nome da conexão	O nome da conexão do BigQuery que permite que o Looker consulte o conjunto de dados de RELATÓRIOS do Cortex. precisa estar ativado.	Todos
Project ID	ID do projeto	O projeto Google Cloud em que o conjunto de dados de relatórios está localizado no BigQuery. Para mais informações, consulte Como identificar projetos.	Todos
Reporting Dataset	Nome do conjunto de dados para relatórios	O conjunto de dados de REPORTING da Cortex Data Foundation implantado, em que as visualizações do conjunto de dados da fonte de dados residem no projeto Google Cloud do BigQuery. Dependendo das configurações de implantação da Cortex Data Foundation, o nome desse conjunto de dados normalmente é do tipo que termina com _REPORTING.	Todos
Client	Número do cliente SAP (mandt)	O número do cliente SAP (mandt) a ser usado para relatórios.	SAP
Sign Change	Yes ou No	Para relatórios de lucros e perdas/demonstração de resultados, a receita geralmente aparece no livro-razão como um número negativo, o que indica um crédito. Ao definir o valor de mudança de sinal como Yes, ele é mostrado como um número positivo nos relatórios da demonstração de resultados.	SAP

Outros requisitos específicos do bloco

Alguns blocos têm requisitos específicos para implantação. Para mais informações, consulte a implantação específica do bloco:

Bloquear	Link para os requisitos adicionais
SAP	Outras especificações do bloco Looker do Cortex Framework para SAP.
Oracle EBS	Especificações adicionais para o bloco de Looker do Cortex Framework para o Oracle EBS.

Outros recursos

Para mais informações sobre o LookML, consulte a documentação e o treinamento a seguir:

• Práticas recomendadas do Looker
• Treinamento do Google Cloud Looker