Connect Looker Studio to Couchbase Columnar using Views and Custom Queries

  • Connect Google Looker Studio to Couchbase Columnar using Tabular Analytics Views (TAVs) or custom queries
  • Create Tabular Analytics Views in Capella for stable datasets or use custom SQL++ queries for flexibility
  • Learn authentication, configuration, schema inference, and troubleshooting

Visão geral

Conecte o Looker Studio à Couchbase Columnar para análise e visualização de dados. Este conector suporta dois modos: Visões de Análise Tabular (TAVs) para fontes de dados estáveis e otimizadas, e consultas personalizadas para uma exploração de dados flexível.

Fluxo de trabalhoOu crie TAVs no Couchbase Capella para relatórios consistentes, ou use consultas SQL++ personalizadas para análises ad-hoc. Os TAVs oferecem uma interface estável e definida por esquema, otimizada para ferramentas de BI, enquanto as consultas personalizadas oferecem máxima flexibilidade para operações de dados complexas.

O conector autentica-se com o Basic Auth no API Columnar (/api/v1/request) e infere o esquema automaticamente usando array_infer_schema Assim, os campos do Looker Studio são criados com tipos razoáveis.

Pré-requisitos

Para utilizar este conector, você precisa:

Acesso Colunar Couchbase

  • Registrar-seVisite Couchbase Capella para criar sua conta
  • Avaliação gratuitaComece com uma versão gratuita para testar o conector
  • Serviço ColunarAtive a análise colunar no seu cluster Capella
  • PreçosO serviço Columnar é cobrado com base no uso de computação e armazenamento. Veja Preços da Capella Para mais detalhes

Requisitos técnicos

  • Uma implementação Couchbase em coluna acessível a partir do Looker Studio. Para informações de configuração, consulte Começar com a arquitetura columnar do Couchbase.
  • Um usuário de banco de dados com permissões para ler as Visualizações de Tabular Analytics (TAVs) do destino e executar consultas.
  • Acesso à rede a partir do Looker Studio para o seu host Columnar.

Instalação

Para adicionar o conector Couchbase Columnar aos seus relatórios do Looker Studio:

  1. Open Looker Studio: Ir para Looker Studio
  2. Criar ou Abrir RelatórioIniciar um novo relatório ou abrir um existente
  3. Adicionar fonte de dadosClique em “Adicionar dados” ou no botão “+”
  4. Encontre o ConectorPesquise “Couchbase Columnar” na galeria de conectores
  5. Autorizar: Atribua as permissões necessárias quando solicitado
  6. Configurar: Siga os passos de autenticação e configuração abaixo

Autenticação

Ao adicionar a fonte de dados, forneça:

  • Path: O host Colunário. Exemplo:
    • Anfitrião da Capella: cb..cloud.couchbase.com
  • NOME DE USUÁRIO E SENHA: Credenciais da base de dados.

O conector valida as credenciais executando uma consulta de teste leve (SELECT 1 AS test;).

Ao adicionar o conector Colunar do Couchbase no Looker Studio, você verá a tela de autenticação:

Authentication Screen

Para o modo “Por Visão”, crie Visões de Análise Tabular no Capella:

  1. Abra a Workbench do AnalyticsNo seu cluster Capella, vá até a aba Análises e execute a ferramenta Analytics Workbench.

  2. Crie a sua consulta SQL++Crie uma consulta que retorne a estrutura de dados desejada para o relatório:

– Exemplos de consultas de aeroporto para criação de TAV
SELECT a.airportname,
       a.city,
       a.país,
       a.faa,
       a.icao
A partir de `travel-sample`.`inventory`.`airport` como uma
ONDE a.country = 'Estados Unidos'
LIMITE 100;
  1. Teste a consultaExecute sua consulta para verificar se ela retorna os resultados e os tipos de dados esperados.

  2. Criar o TAV:

    • Clique Salvar como vista no Workbench do Analytics
    • Escolha Anote para a visualização tabular
    • Defina o esquemaEspecificar os nomes das colunas, os tipos de dados (STRING, NUMBER, BOOLEAN) e marcar os campos de chave primária
    • Nomeie sua visão: Use um nome descritivo como aeroportos_us_redimensionados
    • Salvar: O TAV será criado com um esquema imposto
  3. Verifique a criação: O seu TAV aparecerá no navegador de bancos de dados no âmbito especificado e poderá ser consultado como uma tabela.

Configuração

Escolha o seu modo na tela de configuração:

  • Modo de configuração: Escolha entre Por View ou Utilize a consulta personalizada.

Modo: Por Visão (TAV)

  • Base de Dados Couchbase, Scope, View: Selecionado a partir de listagens que automaticamente descobrem suas bases de dados, scopes e views disponíveis a partir da instância Colunar.
  • Número máximo de linhas: Limite opcional para as linhas retornadas; deixe em branco para não haver limite.

O que corre:

  • Dados: SELECT A partir de `database`.`scope`.`view` [LIMIT n]`
  • Scheda: SELECT array_infer_schema((SELECT VALUE t FROM `database`.`scope`.`view` [LIMIT n])) AS inferred_schema;`

Modo: Por Consulta Personalizada

  • Consulta Colunar Personalizada: Insira sua própria consulta do SQL++ diretamente em uma área de texto.
  • Número máximo de linhas: Não aplicável (limites de controle dentro da sua consulta usando LIMITE).

Exemplo de consulta personalizada:

SELECT empresa_aerea.nome AS nome_da_empresa,
       aerolínea.iata AS iata_code,
       airline.country AS país,
       COUNT(*) como número de rotas
A partir de `travel-sample`.`inventory`.`airline` como airline
Junte o valor `travel-sample`.`inventory`.`route` como rota 
  ON airline.iata = rota.aerolínea
WHERE airline.country = "Estados Unidos"
GRUPO POR: companhia aérea.nome, companhia aérea.iata, companhia aérea.país
LIMITE 100;

O que corre:

  • Dados: A sua consulta personalizada exata conforme introduzida
  • Scheda: SELECT array_infer_schema((your_custom_query)) AS inferred_schema;

Após a autenticação, configure o conector selecionando a sua base de dados, âmbito e visualização:

Database Scope View Configuration

Tipos de Schemas e Campos

  • O conector converte os tipos inferidos em tipos do Looker:
    • numero → NUMERO (métrico)
    • boolean → BOOLEAN (dimensão)
    • string/objects/arrays/null → STRING/TEXT (dimensão)
  • Os campos aninhados são reduzidos ao tamanho desejado usando a notação de pontos e índices de matriz, quando possível (por exemplo, endereço.cidade, schedule[0].day). Valores não estruturados podem ser transformados em strings.

⚠️ Schema Inference NotesPara TAVs, a inferência de esquemas utiliza array_infer_schema em todo o conjunto de dados, a menos que você especifique o valor Maximum Rows (o que adiciona uma cláusula LIMIT para a seleção de amostras). Os tipos de campo são inferidos a partir dos dados analisados e podem não captar variações (por exemplo, campos que contêm tanto texto quanto números em documentos diferentes). Se a inferência do esquema não for possível, verifique se o seu TAV contém dados e considere adicionar um limite de Maximum Rows para uma seleção mais rápida durante testes.

Depois que o seu esquema estiver configurado, você poderá personalizar os campos no painel do Looker Studio:

Field Configuration in Dashboard

Recuperação de Dados

  • São projetados apenas os campos solicitados. Nos casos de campos aninhados, o conector extrai os campos base necessários e extrai os valores no servidor no contexto do Apps Script.
  • Limites de fila:
    • Modo de exibição: Número máximo de linhas controlos LIMITE (branco = sem limite).

Dicas e melhores práticas

  • Prefira as visualizações de análise tabular para ferramentas de BIOs TAVs proporcionam uma interface estável e otimizada com esquemas pré-definidos, tornando-os ideais para relatórios e visualizações consistentes. Além disso, oferecem melhor desempenho do que consultas ad-hoc.
  • Uso LIMITE enquanto exploravaComece com conjuntos de dados menores (por exemplo, LIMITE 1000) para testar a conectividade e a inferência de esquemas de forma rápida. Remova ou aumente os limites assim que estiver satisfeito com a estrutura de dados.

Troubleshooting

  • Erro de autenticaçãoVerifique o host, as credenciais e a disponibilidade da rede para a Columnar.
  • Erros de inferência de esquemasCertifique-se de que o seu TAV existe e contém dados. Experimente adicionar um LIMITE cláusula para a coleta de amostras mais rápida (por exemplo, Limite 100).
  • Erro da API da ColumnarVerifique a mensagem de resposta no Looker Studio e verifique se os nomes de TAV, permissões e que a visualização foi criada corretamente no Capella.
  • TAV vazio ou ausenteVerifique se a sua visualização do Tabular Analytics foi salva corretamente no Analytics Workbench e contém dados.
  • Desconformidade do esquemaSe os campos apresentarem tipos inesperados, verifique se a definição do esquema TAV corresponde aos resultados da consulta. Os TAVs asseguram a consistência do esquema, portanto certifique-se de que a consulta produz dados que correspondem aos tipos de colunas definidos.

Passos seguintes

Depois que o seu conector estiver configurado e os campos estiverem configurados, crie relatórios arrastando e soltando tabelas do painel lateral para a tela principal:

Creating Reports in Looker Studio

  • Crie gráficos no Looker Studio usando os campos compatíveis com o TAV.
  • Iterar sobre as visualizações/questões para moldar o conjunto de dados para análises.
  • Explorar as diversas opções de visualização disponíveis no Looker Studio para criar dashboards atraentes a partir de seus dados Colunais.

Suporte

Para obter assistência com o conector Couchbase Columnar Looker Studio:

Suporte Técnico

Relatórios de problemas

  • Problemas com os conectores: Relatar erros ou solicitações de funcionalidades através do Suporte ao Couchbase
  • Contato GeralPara outras dúvidas, utilize Couchbase Contact
  • Tempo de respostaNosso objetivo é responder a problemas com os conectores dentro de 2 a 3 dias úteis.
  • Conhecidas limitaçõesConsulte a seção de solução de problemas acima para problemas comuns.

Recursos

Política de privacidade

Utilização de Dados do ConectorEste conector acede às credenciais da Couchbase Columnar e aos resultados das consultas apenas para a integração de dados com o Looker Studio. Os dados não são armazenados permanentemente pelo conector e todo o processamento ocorre no ambiente do Looker Studio da Google.

Política de Privacidade OficialPara obter informações completas sobre como o Couchbase trata seus dados, consulte nosso documento oficial. Política de privacidade do Couchbase.

Google Looker StudioEste conector funciona dentro do Google Looker Studio, que possui suas próprias políticas de manipulação de dados. Por favor, consulte Política de Privacidade do Google por suas práticas de tratamento de dados.

Termos de Serviço

Utilização do conector: Use este conector apenas com instâncias Colunais do Couchbase que você possui ou que possui permissão para acessar. Mantenha a segurança de suas credenciais e cumpra as políticas de governança de dados da sua organização.

Termos oficiaisO uso dos produtos e serviços da Couchbase está regido pelos nossos termos e condições oficiais. Termos de Uso do Couchbase. Para clientes empresariais, termos adicionais podem ser aplicados de acordo com as suas especificidades. Contrato de Licença da Couchbase.

Google Looker StudioEste conector funciona dentro do Google Looker Studio e está sujeito às seguintes condições: Termos de Serviço do Google.

Direitos autorais: © 2024 Couchbase, Inc. Todos os direitos reservados.

Informações legaisPara obter informações jurídicas completas, termos de licenciamento e políticas de marcas registradas, visite Jurídico do Couchbase e o nosso Política de Marca Registrada.

Marcas comerciaisO Couchbase e o logotipo do Couchbase são marcas comerciais da Couchbase, Inc. O Google Looker Studio é uma marca registrada da Google LLC.

ContatoPara questões legais, entre em contato legal@couchbase.com.

Deixe a proliferação de bancos de dados no passado

Cada adição de pilha significa mais contas a pagar e mais coisas a administrar. Estimule o quanto você poderia economizar em 2 minutos.