- 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:
- Open Looker Studio: Ir para Looker Studio
- Criar ou Abrir RelatórioIniciar um novo relatório ou abrir um existente
- Adicionar fonte de dadosClique em “Adicionar dados” ou no botão “+”
- Encontre o ConectorPesquise “Couchbase Columnar” na galeria de conectores
- Autorizar: Atribua as permissões necessárias quando solicitado
- 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
- Anfitrião da Capella:
- 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:

Criar visões de análise tabular (TAV) no Capella (recomendado)
Para o modo “Por Visão”, crie Visões de Análise Tabular no Capella:
-
Abra a Workbench do AnalyticsNo seu cluster Capella, vá até a aba Análises e execute a ferramenta Analytics Workbench.
-
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;
-
Teste a consultaExecute sua consulta para verificar se ela retorna os resultados e os tipos de dados esperados.
-
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
-
Verifique a criação: O seu TAV aparecerá no navegador de bancos de dados no âmbito especificado e poderá ser consultado como uma tabela.
- Para mais detalhes, consulte Visualizações do Analytics Tabela e Cachetas, escopetes e coleções.
Configuração
Escolha o seu modo na tela de configuração:
- Modo de configuração: Escolha entre
Por ViewouUtilize 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:

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_schemaem 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:

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 linhascontrolosLIMITE(branco = sem limite).
- Modo de exibição:
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
LIMITEenquanto 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
LIMITEclá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:

- 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
- DocumentaçãoGuia completo em Portal do Desenvolvedor do Couchbase
- Fórum da ComunidadeObtenha ajuda da comunidade no Fóruns do Couchbase
- Comunidade de desenvolvedores: Conecte-se com Comunidade de Desenvolvedores da Couchbase
- DiscórdiaJunte-se a discussões em tempo real Discórdia do Couchbase
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
- Documentação da Couchbase Columnar: Documentos oficiais
- Ajuda do Looker Studio: Suporte ao Google Looker Studio
- Dados de exemplo: Use o bucket de amostras de viagens para testes e exemplos
- Documentação da API: API de Gestão Colunar
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.
Legal
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.