🔗 Envision Looker Studio Connector

Envision bridge between Looker Studio and BigQuery to enforce Envision's policies and security over our customer datasets

📋 Índice

Sobre o Projeto
🔒 Segurança
📊 Como Usar
🏗️ Arquitetura
📞 Suporte
📄 Licença

🎯 Sobre o connector

O EnvisionBigQueryConnector é um conector personalizado desenvolvido pela Envision Tecnologia que estabelece uma ponte segura entre o Looker Studio e o Google BigQuery. Este conector foi projetado especificamente para aplicar as políticas de segurança e controle de acesso da Envision sobre os datasets dos nossos clientes.

🎯 Objetivos Principais

Segurança Aprimorada: Implementa verificações de segurança rigorosas para acesso aos dados
Controle de Acesso: Gerencia permissões baseadas em domínio de email
Flexibilidade: Permite acesso dinâmico a diferentes projetos e datasets do BigQuery
Integração Transparente: Funciona como um conector nativo do Looker Studio

🚀 Funcionalidades

🔐 Controle de Segurança

Verificação de Domínio: Acesso restrito a usuários com acesso aos sistemas da Envision
Validação de Dataset: Sistema de hash MD5 para validar nomes de datasets
Controle de Token: Gerenciamento seguro de tokens de autenticação

📊 Integração com BigQuery

Múltiplos Projetos: Suporte a múltiplos projetos do Google Cloud
Tipos de Tabela: Compatível com tabelas, views e materialized views
SQL Dinâmico: Geração automática de queries SQL otimizadas
Schema Detection: Detecção automática de esquemas de dados

🎛️ Interface de Configuração

Configuração Step-by-Step: Interface guiada para configuração
Seleção Dinâmica: Dropdowns dinâmicos para projetos e tabelas
Validação em Tempo Real: Verificações de configuração instantâneas

Gerenciamento de Segredos

Integração com Google Secret Manager
Chaves de validação criptografadas
Tokens de acesso seguros

📊 Como Usar

1. Configuração Inicial

Acesse o Looker Studio
Adicione uma nova fonte de dados
Selecione "EnvisionBig" na lista de conectores

2.1) Authorize o LookerStudio a acessar sua conta do Google

Para usar o LookerStudio connector você precisa ter uma conta de e-mail do Google
Ao selecionar o EnvisionBig o Looker pedirá autorização para utilizar seus dados do Google

2.1) Authorize o LookerStudio a acessar os dados da sua conta da Envision

Preencha suas informações de usuário e senha, as mesmas que você utiliza para administrar nossos produtos
Clique no botão autorizar.

3) Seleção de Dataset e Tabela

Selecione a tabela desejada
O sistema validará automaticamente as permissões

4) Visualização dos Dados

Configure os campos desejados
Aplique filtros e agregações
Visualize os dados no Looker Studio

🏗️ Arquitetura

Componentes Principais

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Looker Studio │────│ EnvisionBigQuery │────│   Google        │
│                 │    │   Connector      │    │   BigQuery      │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │ Security Checks  │
                       │ & Validation     │
                       └──────────────────┘

Fluxo de Dados

Autenticação: Verificação de usuário e domínio
Validação: Checagem de permissões e formato de dataset
Consulta: Execução de queries BigQuery otimizadas
Retorno: Dados formatados para o Looker Studio

📞 Suporte

Canais de Suporte

GitHub Issues: Reportar Problemas
Email: Entre em contato através do nosso site
Documentação: Consulte esta documentação para dúvidas comuns

Informações da Empresa

Empresa: Envision Tecnologia
Website: www.envisiontecnologia.com.br
GitHub: cironolaenvision

Problemas Comuns

Erro de Validação de Dataset

Error: The dataset name is in a incorrect format, expected format: [DataSetName]-[DataSetHash]

Solução: Verifique se o nome do dataset segue o formato correto com hash MD5.

Erro de Acesso Negado

Error: Invalid dataset name!

Solução: Verifique se você tem permissão para acessar o dataset e se o hash está correto.