24 integrações de código aberto

    Integrações e adaptadores do GizmoSQL

    O GizmoSQL usa Apache Arrow Flight SQL; as ferramentas que você já utiliza se conectam nativamente: drivers para todas as linguagens, agentes de IA via MCP, replicação a partir do Oracle e do Snowflake, transformações dbt e SQLMesh, APIs de dataframes Python, painéis de BI, clientes SQL de desktop e operações Kubernetes. Organizados pela ordem de adoção da maioria das equipes, começando pelos mais importantes.

    01Drivers🚀 Novo

    Driver ADBC 2.0

    O driver nativo que sustenta todas as demais integrações — Python, Go, R, Rust, C#, C/C++ e JavaScript.

    O driver ADBC do GizmoSQL é um driver Arrow Database Connectivity nativo em Go, compilado como biblioteca C compartilhada; uma base de código atende a todas as linguagens ADBC. Os resultados fluem do servidor como lotes Arrow via gRPC, sem conversão linha a linha; por isso, o mesmo driver sustenta as integrações dbt, SQLMesh, Ibis, SQLFrame, QGIS, Node.js e MCP desta página.

    A versão 2.0 acrescenta recursos ausentes em um driver Flight SQL básico: detecção automática de DDL/DML para execução imediata no servidor, suporte a RETURNING, URIs gizmosql:// com TLS por padrão, cancelamento de consultas no servidor e login OAuth/SSO no navegador para GizmoSQL Enterprise. O pacote Python mantém a API 1.x; atualizar exige um comando pip.

    O que oferece

    • pip install adbc-driver-gizmosql, além de bindings para Go, R e C/C++
    • OAuth/SSO via auth_type="external" em servidores Enterprise
    • Detecção automática de DDL/DML e suporte a RETURNING
    • Cancelamento no servidor com Ctrl+C ou cursor.close()
    • Perfis de conexão TOML com substituição por variáveis de ambiente
    • Rastreamento e logs OpenTelemetry
    Python
    1pip install adbc-driver-gizmosql
    2
    3from adbc_driver_gizmosql import dbapi as gizmosql
    4
    5with gizmosql.connect("gizmosql://localhost:31337",  # TLS by default
    6                      username="gizmosql_user",
    7                      password="gizmosql_password",
    8                      tls_skip_verify=True,
    9                      ) as conn:
    10    with conn.cursor() as cur:
    11        cur.execute("SELECT n_nationkey, n_name FROM nation LIMIT 5")
    12        print(cur.fetch_arrow_table())

    Instalação em Go: go get github.com/gizmodata/gizmosql-adbc/go@latest. Apache-2.0.

    02Drivers🚀 Novo

    Driver JDBC

    Conecte DataGrip, Tableau e qualquer aplicação Java com uma URL JDBC padrão (o DBeaver já inclui o driver).

    O driver JDBC do GizmoSQL é um fork do driver JDBC Apache Arrow Flight SQL, distribuído em um único JAR e publicado no Maven Central como com.gizmodata:gizmosql-jdbc-driver. Tudo o que usa java.sql funciona: clientes SQL de desktop, servidores BI, aplicações Spring e JPA e ferramentas de dados JVM. Ele também sustenta o driver Metabase e o cliente de linha de comando SQLLine.

    As conexões usam URLs jdbc:gizmosql://host:port (o formato anterior jdbc:arrow-flight-sql:// continua funcionando) com usuário/senha, token bearer ou OAuth/SSO no navegador. TLS e TLS mútuo são configuráveis por conexão, inclusive armazenamentos de confiança personalizados e certificados de cliente.

    O que oferece

    • Download de um único JAR ou dependência Maven Central
    • Usuário/senha, token bearer e OAuth/SSO (authType=external)
    • TLS e mTLS com armazenamentos de confiança personalizados e certificados de cliente
    • Funciona com DataGrip, Tableau e qualquer ferramenta JDBC; integrado ao DBeaver 26.1+
    Java
    // Maven: com.gizmodata:gizmosql-jdbc-driver:1.7.0
    String url = "jdbc:gizmosql://your-server.example.com:31337?useEncryption=true";
    
    try (Connection conn = DriverManager.getConnection(url, "user", "password");
         Statement stmt = conn.createStatement();
         ResultSet rs = stmt.executeQuery("SELECT * FROM my_table")) {
        while (rs.next()) {
            System.out.println(rs.getString(1));
        }
    }

    Requer JDK 17 ou mais recente a partir da v1.7.0 (a linha 1.6.x aceita JDK 11). Apache-2.0.

    03Ferramentas🚀 Novo

    DBeaver (driver integrado)

    O GizmoSQL está incluído no DBeaver 26.1+. Selecione-o na lista de conexões; sem configuração JDBC manual.

    Desde o DBeaver 26.1.0, o GizmoSQL é um driver nativo integrado, contribuído pela GizmoData e incorporado ao projeto principal. Abra New Database Connection, pesquise GizmoSQL e o DBeaver baixará o driver JDBC GizmoSQL mais recente do Maven Central no primeiro uso. Sem procurar JAR, digitar classe de driver ou lembrar modelo de URL.

    A definição integrada usa a porta 31337 e criptografia por padrão, permite selecionar um catálogo no diálogo de conexão ou na URL e inclui um modelo de metadados GizmoSQL para o navegador de esquemas mostrar DDL de visões diretamente do servidor. É o mesmo driver JDBC GizmoSQL; suas propriedades de conexão, incluindo tokens bearer e OAuth/SSO, se aplicam.

    O que oferece

    • Entrada GizmoSQL nativa na lista de conexões do DBeaver (26.1.0 e posteriores)
    • Download automático do driver JDBC pelo Maven Central
    • Padrões adequados: porta 31337, TLS ativo, seleção opcional de catálogo
    • Modelo de metadados GizmoSQL com DDL de visões no navegador de esquemas
    Conectar
    Database → New Database Connection → search "GizmoSQL"
    Host:     gizmosql.example.com
    Port:     31337
    Username: analyst
    Password: ••••••••
    (DBeaver fetches com.gizmodata:gizmosql-jdbc-driver on first connect)

    Em versões anteriores do DBeaver, cadastre o JAR JDBC manualmente em Database → Driver Manager.

    04IA e agentes🚀 Novo

    Servidor MCP

    Permita que Claude Desktop, Claude Code e qualquer cliente MCP explorem seu esquema e executem SQL.

    O servidor MCP do GizmoSQL implementa Model Context Protocol e é uma extensão Claude Desktop instalável em um clique. Após a instalação, o Claude pode listar catálogos, esquemas e tabelas, descrever colunas, explicar planos e executar SQL parametrizado em qualquer servidor GizmoSQL acessível pela sua máquina, inclusive em redes privadas via VPN. Funciona localmente com o cliente oficial Node.js e driver ADBC nativo, sem enviar telemetria.

    Foi feito para conectar um LLM a dados de produção. Um controle SQL mantém somente leitura, a menos que GIZMOSQL_ALLOW_WRITES=true seja definido; limites de linhas e de tempo são aplicados no servidor, credenciais nunca aparecem na saída das ferramentas e vários servidores podem ser configurados e alternados durante a conversa. O transporte Streamable HTTP com token bearer atende clientes MCP remotos.

    O que oferece

    • npx -y @gizmodata/gizmosql-mcp ou extensão .mcpb do Claude Desktop
    • Somente leitura por padrão, com limites de linhas e tempo aplicados pelo servidor
    • Exploração de esquemas, planos EXPLAIN e run_query parametrizado
    • Vários servidores GizmoSQL em uma conversa, com login_sso para Enterprise
    Claude Code
    claude mcp add gizmosql \
      -e GIZMOSQL_HOST=gizmosql.internal.example.com \
      -e GIZMOSQL_PORT=31337 \
      -e GIZMOSQL_USERNAME=analyst \
      -e GIZMOSQL_PASSWORD='your-password' \
      -- npx -y @gizmodata/gizmosql-mcp

    Node.js 22 ou mais recente para execução por npx; o pacote Claude Desktop dispensa instalação do Node. Apache-2.0.

    05Carga de dados🚀 Novo

    adbc-replicate

    Replique esquemas inteiros do Oracle, Snowflake, PostgreSQL ou DuckDB para o GizmoSQL usando um único arquivo YAML.

    O adbc-replicate copia para o GizmoSQL os esquemas, as tabelas e as visões que você selecionar em um banco de dados de origem. Ele lê usando o driver ADBC da origem e envia o fluxo Arrow diretamente para a ingestão em lote do GizmoSQL (um Flight SQL DoPut). Assim, os dados permanecem em formato colunar de ponta a ponta, não há arquivos intermediários e o cliente mantém na memória cerca de um lote, independentemente do tamanho da tabela. Para usar Oracle, não é necessário instalar o Oracle Client: basta usar o driver ADBC para Oracle da GizmoData.

    A ferramenta foi projetada para executar em horários programados contra sistemas de produção. As máscaras de coluna são aplicadas dentro da origem, de modo que os valores brutos não saem dela; se uma máscara não corresponder a nenhuma coluna, a execução é interrompida. Cada tabela pode ser lida em um mesmo ponto no tempo (um SCN do Oracle, um snapshot do PostgreSQL ou o time travel do Snowflake). Nas execuções seguintes, somente tabelas alteradas são copiadas, ou os dados são mesclados incrementalmente pelas respectivas chaves. As visões são convertidas para SQL do DuckDB e recriadas; construções que não possam ser traduzidas fielmente são reportadas, sem alteração. Clientes que usam Snowflake e Oracle executam a ferramenta de hora em hora para copiar dados ao GizmoData Cloud, onde seus agentes de IA podem consultá-los via MCP.

    O que oferece

    • Seleção de esquemas, tabelas e visões por glob ou expressão regular
    • Exclusão e mascaramento de colunas (null, hash com salt, redação, SQL) dentro da origem
    • Snapshots consistentes e cópia apenas do que mudou, ou mesclagens incrementais
    • Visões convertidas para SQL do DuckDB, incluindo CONNECT BY e junções (+) do Oracle
    • Histórico de execuções no destino, notificações por Slack/webhook, imagem de contêiner e chart Helm
    Instalar e executar
    pip install "adbc-replicate[oracle,gizmosql]"
    
    adbc-replicate init replicate.yaml
    adbc-replicate plan --config replicate.yaml
    adbc-replicate run --config replicate.yaml

    Extras: oracle, snowflake, postgresql, duckdb, gizmosql ou all. Python 3.11 ou mais recente. Também disponível como ghcr.io/gizmodata/adbc-replicate e como chart Helm para execuções programadas. Apache-2.0.

    06IA e agentes🚀 Novo

    Carregador de PDF

    Carregue manuais PDF no GizmoSQL para clientes SQL e agentes MCP pesquisarem o texto e recuperarem os arquivos originais.

    gizmosql-pdf-loader é uma ferramenta de linha de comando e biblioteca Python que carrega PDFs em um servidor GizmoSQL via Arrow Flight SQL / ADBC. Para cada PDF, armazena metadados (nome, tamanho, SHA-256, número de páginas, título, autor, datas) na tabela documents, bytes do arquivo em blocos de tamanho fixo (8 MiB por padrão, para nenhuma mensagem Arrow Flight ultrapassar o limite gRPC) em document_chunks, e uma linha de texto extraído por página em document_pages. Páginas só de imagem recebem OCR pelo Tesseract incluído no wheel PyMuPDF, sem instalação adicional. Surgiu do pedido de um cliente para tornar uma coleção de manuais de equipamentos pesquisável por SQL e por um agente de IA.

    Funções auxiliares são criadas junto às tabelas: search_pages(term) busca substrings sem distinguir maiúsculas e minúsculas, com trecho de contexto; search_pages_ranked(term, top_k) retorna resultados com radicalização de palavras e classificação BM25 pela extensão fts do DuckDB. Qualquer cliente SQL, servidor MCP do GizmoSQL ou pipeline de recuperação pode consultar o texto e transmitir o arquivo original de volta em blocos. Funciona com catálogos DuckDB e DuckLake, e reexecuções são idempotentes porque os documentos são identificados pelo SHA-256.

    O que oferece

    • pip install gizmosql-pdf-loader: uma CLI (load, list, search, index) e uma API Python
    • Tabelas documents, document_chunks e document_pages e macros search_pages() e search_pages_ranked()
    • OCR de páginas só de imagem sem instalação extra (Tesseract incluído no wheel PyMuPDF)
    • Busca textual BM25 via fts do DuckDB, em catálogos de arquivo DuckDB e DuckLake
    CLI
    pip install gizmosql-pdf-loader
    
    # .env: GIZMOSQL_HOSTNAME, GIZMOSQL_PORT, GIZMOSQL_USERNAME, GIZMOSQL_PASSWORD,
    #       GIZMOSQL_CATALOG (required), GIZMOSQL_SCHEMA (default: pdf_docs)
    gizmosql-pdf-loader load --source-dir source_pdf_files
    gizmosql-pdf-loader list
    gizmosql-pdf-loader search "hydraulic pump relief valves" --ranked --limit 5
    
    # Then from any SQL client:
    #   SELECT file_name, page_number, score, snippet
    #     FROM my_lake.pdf_docs.search_pages_ranked('hydraulic pump relief valves', top_k := 10);

    Python 3.10 ou mais recente. Criar o índice textual exige o papel admin do GizmoSQL; consultá-lo não exige. Apache-2.0.

    07Ferramentas🚀 Novo

    GizmoSQL UI

    Um editor SQL gratuito no navegador, distribuído em executável único.

    O GizmoSQL UI é a forma mais rápida de explorar um servidor GizmoSQL: editor Monaco com destaque de sintaxe e preenchimento automático, navegador de catálogos, esquemas, tabelas e colunas, e grade de resultados com reconhecimento de tipos e exportação para CSV, TSV, JSON ou Parquet. Usa Arrow Flight SQL diretamente, com TLS e autenticação.

    É instalado como um executável autossuficiente por Homebrew em macOS e Linux, MSI assinado em Windows ou download direto, e abre no navegador em localhost:3000. Em um servidor GizmoSQL Enterprise, adiciona login OAuth/SSO e tela de administração de sessões.

    O que oferece

    • Editor SQL Monaco com preenchimento automático e navegador de esquemas
    • Grade de resultados com reconhecimento de tipos e exportação CSV, TSV, JSON e Parquet
    • Instalação por Homebrew, MSI Windows ou executável independente
    • Login OAuth/SSO e administração de sessões em servidores Enterprise
    macOS / Linux
    brew tap gizmodata/tap
    brew trust gizmodata/tap  # required as of Homebrew 6.0
    brew install gizmosql-ui
    gizmosql-ui

    Windows: baixe GizmoSQL-UI-x64.msi ou GizmoSQL-UI-arm64.msi na página de versões do GitHub. Apache-2.0.

    08Transformação🚀 Novo

    Adaptador dbt

    Execute seu projeto dbt no GizmoSQL com paridade de recursos em relação ao dbt-duckdb.

    dbt-gizmosql transforma um servidor GizmoSQL em destino de data warehouse para dbt. Suporta materializações de tabelas e visões, modelos incrementais com estratégias append, delete+insert, merge e microbatch, snapshots, tratamento de alterações de esquema e aplicação de restrições (CHECK, NOT NULL, UNIQUE, PRIMARY KEY, FOREIGN KEY). Gravações de arquivos Parquet, CSV e JSON externos são executadas no servidor.

    Modelos Python executam no cliente em DuckDB local e enviam resultados ao GizmoSQL por ingestão em massa ADBC, com session.remote_sql() para execução no servidor. Desde a v1.12.0, o adaptador usa o driver ADBC nativo 2.0; perfis podem usar OAuth/SSO no navegador com auth_type: external em vez de senha armazenada.

    O que oferece

    • Materializações de tabela, visão, incrementais (append, delete+insert, merge, microbatch) e snapshot
    • Modelos Python com ingestão em massa ADBC e execução remota por remote_sql()
    • Perfis OAuth/SSO (auth_type: external) e opções TLS
    • Aplicação de restrições e exportação Parquet/CSV/JSON no servidor
    profiles.yml
    # python -m pip install dbt-core dbt-gizmosql
    my-gizmosql-db:
      target: dev
      outputs:
        dev:
          type: gizmosql
          host: gizmosql.example.com
          port: 31337
          auth_type: external   # browser-based OAuth/SSO
          use_encryption: True
          threads: 2

    Apache-2.0.

    09Transformação🚀 Novo

    Adaptador SQLMesh

    Planeje, aplique e execute transformações SQLMesh no GizmoSQL.

    sqlmesh-gizmosql cadastra o GizmoSQL como mecanismo SQLMesh. Importe o pacote e o SQLMesh poderá planejar e executar modelos em um servidor GizmoSQL com suporte completo a catálogos (criar, remover e alternar bancos), transações e ingestão em massa ADBC, gerando SQL no dialeto DuckDB.

    As conexões usam o driver ADBC nativo 2.0, com TLS por padrão (use_encryption) e opção de ignorar verificação de certificados para servidores autoassinados. OAuth/SSO no navegador com auth_type: external dispensa armazenar usuário ou senha na configuração SQLMesh.

    O que oferece

    • Adaptador de mecanismo SQLMesh com suporte completo a catálogos e transações
    • Ingestão em massa ADBC via Arrow Flight SQL
    • OAuth/SSO (auth_type: external) e configuração TLS
    • Geração de SQL no dialeto DuckDB
    Python
    1# pip install sqlmesh-gizmosql
    2import sqlmesh_gizmosql  # Registers GizmoSQL adapter
    3from sqlmesh import Context
    4
    5context = Context(paths="path/to/project")

    Apache-2.0.

    10Python🚀 Novo

    API DataFrame PySpark (SQLFrame)

    Execute código DataFrame no estilo PySpark no GizmoSQL sem cluster Spark.

    sqlframe-gizmosql é o backend GizmoSQL para SQLFrame, que implementa a API DataFrame PySpark sobre mecanismos SQL. Transformações PySpark existentes executam no GizmoSQL trocando o construtor de sessão; assim, equipes transferem tarefas Databricks e Spark sem reescrevê-las.

    A sessão usa o driver ADBC nativo 2.0 com URIs gizmosql://, TLS por padrão e OAuth/SSO via auth_type="external". Adiciona session.ingest() para cargas em massa ADBC, leitura no cliente de arquivos locais JSON, CSV e Parquet com inferência de esquema compatível com Spark, e spans de rastreamento OpenTelemetry para cada instrução.

    O que oferece

    • API DataFrame compatível com PySpark executada como SQL DuckDB
    • Driver ADBC nativo 2.0 com OAuth/SSO e TLS
    • Carga em massa por session.ingest() via ADBC
    • Leitura local de JSON/CSV/Parquet com inferência de esquema no estilo Spark
    Python
    1# pip install sqlframe-gizmosql
    2from sqlframe_gizmosql import GizmoSQLSession
    3
    4session = GizmoSQLSession.builder \
    5    .config("gizmosql.uri", "gizmosql://localhost:31337") \
    6    .config("gizmosql.username", "gizmosql_user") \
    7    .config("gizmosql.password", "gizmosql_password") \
    8    .config("gizmosql.tls_skip_verify", True) \
    9    .getOrCreate()
    10
    11df = session.sql("SELECT 1 as id, 'hello' as message")
    12df.show()

    Apache-2.0.

    11Python🚀 Novo

    Biblioteca Python (servidor embarcado)

    Execute pip install gizmosql e inicie um servidor GizmoSQL real pelo Python.

    O pacote gizmosql executa um servidor GizmoSQL Flight SQL como subprocesso gerenciado. No primeiro uso, baixa o binário correspondente à plataforma (macOS arm64, Linux amd64/arm64, Windows amd64/arm64) para cache local, sem exigir ferramentas de compilação ou Docker. O pacote não tem dependências de runtime.

    O gerenciador de contexto Server() escolhe uma porta livre, aguarda o servidor aceitar conexões e o encerra corretamente na saída; ideal para fixtures pytest, notebooks e fluxos com vários agentes que precisam de servidor SQL compartilhado sob demanda. As versões acompanham as tags do servidor GizmoSQL, e o extra opcional [adbc] adiciona Server.connect() pelo driver ADBC nativo.

    O que oferece

    • Inicializador de servidor sem dependências, com binários em cache
    • Ciclo de vida por gerenciador de contexto para testes e notebooks
    • Versionamento acompanha os lançamentos do servidor GizmoSQL
    • Extra opcional [adbc] para conexão no próprio processo
    Python
    1# pip install 'gizmosql[adbc]'
    2import gizmosql
    3
    4with gizmosql.Server(password="tiger") as srv:
    5    print(srv.uri)            # gizmosql://127.0.0.1:42173?transport=tcp
    6    print(srv.username, srv.password)
    7    # ... point any GizmoSQL driver (ADBC, JDBC, ...) at srv.uri ...

    Apache-2.0.

    12Python

    Dialeto SQLAlchemy

    SQLAlchemy ORM e Core no GizmoSQL, via ADBC.

    sqlalchemy-gizmosql-adbc-dialect cadastra o dialeto gizmosql no SQLAlchemy; modelos declarativos, sessões e consultas Core executam em um servidor GizmoSQL por ADBC. O SQL é gerado no dialeto DuckDB, e as conexões usam URL.create(drivername="gizmosql", ...) e as opções useEncryption e disableCertificateVerification para TLS.

    É a base do driver Apache Superset abaixo e de qualquer framework Python que espera um mecanismo SQLAlchemy. O servidor precisa usar o backend DuckDB padrão.

    O que oferece

    • Suporte a SQLAlchemy ORM (modelos declarativos, Session) e Core
    • URLs de mecanismo gizmosql:// com opções TLS
    • Geração de SQL no dialeto DuckDB
    • Base da integração Apache Superset
    Python
    1# pip install sqlalchemy-gizmosql-adbc-dialect
    2url = URL.create(drivername="gizmosql",
    3                 host="localhost",
    4                 port=31337,
    5                 username=os.getenv("GIZMOSQL_USERNAME", "gizmosql_username"),
    6                 password=os.getenv("GIZMOSQL_PASSWORD", "gizmosql_password"),
    7                 query={"disableCertificateVerification": "True",
    8                        "useEncryption": "True"})
    9engine = create_engine(url=url)

    Apache-2.0.

    13BI e dashboards

    Driver Apache Superset

    Painéis e SQL Lab do Apache Superset com GizmoSQL.

    superset-sqlalchemy-gizmosql-adbc-dialect é uma versão do dialeto SQLAlchemy compatível com Superset, fixada na versão SQLAlchemy incluída no Apache Superset 6.0. Instale no ambiente Superset e adicione um banco com URL gizmosql://; gráficos, painéis e SQL Lab consultarão o GizmoSQL diretamente por ADBC.

    A URL de conexão inclui opções TLS e um parâmetro catalog opcional para selecionar um catálogo diferente do padrão. O servidor precisa usar o backend DuckDB padrão.

    O que oferece

    • Dialeto SQLAlchemy compatível com Superset 6.0
    • URLs de conexão gizmosql:// com opções TLS
    • Parâmetro catalog= para catálogos diferentes do padrão
    • Gráficos, painéis e SQL Lab via ADBC
    URL de conexão Superset
    pip install superset-sqlalchemy-gizmosql-adbc-dialect
    
    # Superset → Settings → Database Connections → SQLAlchemy URI:
    gizmosql://gizmosql_username:gizmosql_password@localhost:31337?disableCertificateVerification=True&useEncryption=True

    Apache-2.0.

    14Python

    Backend Ibis

    Expressões de dataframe Python portáveis, compiladas para GizmoSQL.

    ibis-gizmosql adiciona o GizmoSQL como backend Ibis. Você escreve expressões de dataframe tipadas e de avaliação preguiçosa em Python, e o Ibis as compila para SQL DuckDB executado no servidor GizmoSQL; o mesmo código analítico pode circular entre GizmoSQL, DuckDB local e outros backends Ibis.

    Conecte com argumentos nomeados ou URL ibis.connect("gizmosql://..."). Desde a v1.1.0, o backend usa o driver ADBC nativo 2.0, com opções TLS e OAuth/SSO no navegador via auth_type="external".

    O que oferece

    • API de dataframe Ibis compilada para SQL DuckDB no servidor
    • Conexões por argumentos nomeados ou URL gizmosql://
    • OAuth/SSO (auth_type="external") e opções TLS
    • Driver ADBC nativo 2.0 com DDL/DML imediato e RETURNING
    Python
    1# pip install ibis-gizmosql
    2import ibis
    3
    4con = ibis.gizmosql.connect(host="localhost",
    5                            user=os.getenv("GIZMOSQL_USERNAME", "gizmosql_user"),
    6                            password=os.getenv("GIZMOSQL_PASSWORD", "gizmosql_password"),
    7                            port=31337,
    8                            use_encryption=True,
    9                            disable_certificate_verification=True)
    10print(con.tables)
    11t = con.table('lineitem')

    Apache-2.0.

    15BI e dashboards🚀 Novo

    Conector Power BI

    Modos DirectQuery e Import no Power BI Desktop, via ADBC com query folding.

    O conector Power BI do GizmoSQL é um conector personalizado Power Query que usa ADBC e Arrow Flight SQL, sem camada ODBC intermediária. A versão 2.0 foi reescrita sobre o driver nativo; o instalador MSI configura a DLL do driver, o conector assinado e o certificado confiável em uma etapa.

    Suporta DirectQuery para painéis em tempo real e modo Import para snapshots, enviando filtros, junções e agregações ao servidor como SQL nativo do DuckDB. A autenticação inclui usuário/senha, tokens bearer e OAuth/SSO no navegador com GizmoSQL Enterprise.

    O que oferece

    • Instalador MSI (x64) em uma etapa com conector .pqx assinado
    • Modos DirectQuery e Import
    • Query folding para SQL nativo do DuckDB
    • Autenticação básica, por token bearer e OAuth/SSO

    Requer servidor GizmoSQL v1.23.0 ou mais recente. Apache-2.0.

    16Drivers🚀 Novo

    Driver ODBC

    Excel, Tableau, pyodbc e qualquer outra aplicação ODBC 3.x.

    O driver ODBC do GizmoSQL, derivado do driver ODBC Dremio Flight SQL, oferece às ferramentas exclusivamente ODBC um caminho nativo Arrow Flight SQL até o GizmoSQL. É totalmente compatível com ODBC 3.x, distribuído como fórmula Homebrew no macOS, MSI no Windows e biblioteca compartilhada no Linux, e descobre chaves primárias e estrangeiras para as ferramentas de modelagem enxergarem relações reais.

    As conexões aceitam autenticação básica, token e OAuth no navegador (authType=basic|token|external), TLS com o armazenamento de confiança do sistema e pings HTTP/2 keepalive para sessões longas. Também suporta Power BI DirectQuery e Import para equipes que preferem ODBC ao conector dedicado.

    O que oferece

    • Driver ODBC 3.x para macOS, Windows e Linux
    • Autenticação básica, token e OAuth (authType=external)
    • Descoberta de chaves primárias e estrangeiras
    • TLS com armazenamento de confiança do sistema e HTTP/2 keepalive
    Python (pyodbc)
    1# brew install gizmodata/tap/gizmosql-odbc
    2import pyodbc
    3conn = pyodbc.connect(
    4    "Driver=GizmoSQL ODBC Driver;"
    5    "host=localhost;"
    6    "port=31337;"
    7    "uid=gizmosql_user;"
    8    "pwd=gizmosql_password;"
    9    "useEncryption=true"
    10)
    11cursor = conn.cursor()
    12cursor.execute("SELECT * FROM my_table LIMIT 10")

    Windows: GizmoSQL-ODBC-Driver-x64.msi na página de versões. Apache-2.0.

    17BI e dashboards🚀 Novo

    Driver Metabase

    Construtor de perguntas, SQL nativo e painéis Metabase sobre GizmoSQL.

    O driver Metabase do GizmoSQL é um plugin JAR de instalação direta, baseado no driver JDBC GizmoSQL. Baixe o JAR da sua linha Metabase, coloque-o no diretório plugins, adicione as opções JVM documentadas e reinicie; o GizmoSQL aparecerá como tipo de banco, com seleção de catálogo e filtros de inclusão/exclusão de esquemas na sincronização.

    Suporta usuário/senha, token bearer/JWT e OAuth2, TLS por padrão com CA personalizada e certificados de cliente para TLS mútuo, e todos os recursos Metabase: filtros de campos, MBQL, SQL nativo, tabelas dinâmicas, parâmetros de painéis e envio opcional de CSV e transformações de tabelas.

    O que oferece

    • Plugins JAR para as linhas Metabase 62 e 63+
    • Autenticação por usuário/senha, JWT e OAuth2
    • TLS por padrão, CA personalizada e suporte a mTLS
    • MBQL, SQL nativo, tabelas dinâmicas e parâmetros de painéis
    18BI e dashboards🚀 Novo

    Plugin Grafana

    Painéis de séries temporais diretamente do GizmoSQL com macros $__timeFilter.

    O plugin de fonte de dados GizmoSQL (gizmodata-gizmosql-datasource) conecta Grafana ao GizmoSQL por Arrow Flight SQL nativo. Escreva SQL no editor e use as macros padrão de período do Grafana ($__timeFrom, $__timeTo, $__timeFilter) e variáveis de modelo para criar painéis sobre dados operacionais e analíticos.

    Suporta TLS com opção de ignorar verificação de certificado, autenticação por usuário/senha ou token e requer Grafana 10.0 ou mais recente.

    O que oferece

    • Fonte de dados Arrow Flight SQL nativa para Grafana 10+
    • Macros de período e variáveis de modelo
    • TLS com opção de ignorar verificação de certificado
    • Autenticação por usuário/senha e token
    Consulta de série temporal
    SELECT
      order_date AS time,
      SUM(total_price) AS revenue
    FROM orders
    WHERE $__timeFilter
    GROUP BY order_date
    ORDER BY time

    Apache-2.0.

    19Operações🚀 Novo

    Operador Kubernetes

    Declare servidores GizmoSQL como recursos personalizados Kubernetes.

    O GizmoSQL Operator é um controlador Kubernetes que gerencia o ciclo de vida das instâncias GizmoSQL. Instale com um comando Helm e crie recursos personalizados GizmoSQLServer; o operador provisiona, configura e reconcilia cada instância, permitindo implantar vários servidores isolados declarativamente junto com o restante do cluster.

    Integra-se ao RBAC, à rede e ao armazenamento Kubernetes. Se preferir não operar Kubernetes, o GizmoData Cloud provisiona e opera clusters GizmoSQL para você.

    O que oferece

    • Operador instalado com Helm e CRD GizmoSQLServer
    • Configuração declarativa e ciclo de vida automatizado
    • Várias instâncias isoladas por cluster
    • Integração nativa com RBAC, rede e armazenamento
    Helm e recurso personalizado
    # helm install gizmosql-operator oci://registry-1.docker.io/gizmodata/gizmosql-operator-chart \
    #   --namespace gizmosql-system --create-namespace
    apiVersion: gizmodata.com/v1alpha1
    kind: GizmoSQLServer
    metadata:
      name: example-gizmosql
      namespace: default
    spec:
      resources:
        limits:
          cpu: "1"
          memory: "2Gi"

    Apache-2.0.

    20Drivers🚀 Novo

    Cliente Node.js

    GizmoSQL em TypeScript e JavaScript, com retorno de tabelas Arrow.

    @gizmodata/gizmosql-client é o cliente TypeScript oficial para GizmoSQL e outros servidores Arrow Flight SQL. A versão 2.0 utiliza o driver ADBC nativo em Go por meio do gerenciador de drivers ADBC, para que serviços Node.js, funções serverless e ferramentas de CLI recebam os mesmos resultados Arrow em streaming que o Python.

    A versão 2.2 adiciona vinculação de parâmetros: passe valores para marcadores ? ou $1 como segundo argumento, e eles chegarão ao servidor como dados Arrow tipados em uma instrução preparada, sem interpolação no SQL. Adiciona executeStream() para obter lotes Arrow sob demanda e cancelamento AbortSignal que interrompe a instrução no servidor. TLS, usuário/senha, token bearer e descoberta de URL OAuth/SSO pelo handshake Flight completam os recursos. Também é o cliente usado pelo servidor MCP.

    O que oferece

    • npm install @gizmodata/gizmosql-client
    • Resultados nativos Arrow de execute(), lotes transmitidos por executeStream()
    • Vinculação de parâmetros (? / $1) como valores Arrow tipados, sem interpolação de strings
    • Cancelamento AbortSignal e prazos no cliente
    • TLS, autenticação básica, token bearer e descoberta de URL OAuth/SSO
    TypeScript
    // npm install @gizmodata/gizmosql-client
    import { FlightSQLClient } from "@gizmodata/gizmosql-client";
    
    const client = new FlightSQLClient({
      host: "localhost",
      port: 31337,
      tlsSkipVerify: true,
      username: "gizmosql",
      password: "your-password",
    });
    
    // Positional parameters, in placeholder order
    const table = await client.execute(
      "SELECT id, name FROM users WHERE id = ? AND name = ?",
      [42, "Alice"]
    );
    console.log(table.toArray());
    await client.close();

    Requer Node.js 22 ou mais recente. Apache-2.0.

    21Ferramentas🚀 Novo

    Cliente de linha de comando SQLLine

    Um shell SQL para GizmoSQL em executável único, baseado em SQLLine e no driver JDBC.

    gizmosqlline reúne SQLLine e o driver JDBC GizmoSQL em um executável com todas as dependências. Instale pelo tap Homebrew ou baixe o binário; conecte com uma URL jdbc:gizmosql:// e execute SQL interativamente ou por scripts.

    Suporta TLS, os métodos de autenticação do driver JDBC, incluindo OAuth/SSO por troca de código de autorização no servidor, e cancelamento de consultas tanto no cliente quanto no servidor.

    O que oferece

    • Tap Homebrew ou download de binário único
    • SQL interativo e por scripts via JDBC
    • Autenticação TLS, senha, token e OAuth/SSO
    • Cancelamento de consultas no cliente e no servidor
    Instalar e conectar
    brew install gizmodata/tap/gizmosqlline
    gizmosqlline -u "jdbc:gizmosql://localhost:31337" -n user -p password

    Apache-2.0; inclui SQLLine (BSD-3-Clause).

    22Operações

    Proxy Flight SQL via WebSocket

    Disponibilize um servidor GizmoSQL para clientes de navegador e WebSocket que não usam gRPC.

    flight-sql-websocket-proxy é um par de servidor e cliente Python que coloca um endpoint WebSocket à frente de um servidor Arrow Flight SQL como o GizmoSQL. Aplicações web e ambientes que não abrem conexões gRPC enviam SQL por WebSocket e recebem resultados, enquanto o proxy mantém a conexão Flight SQL com o banco.

    O proxy usa TLS, autentica no backend com usuário e senha e pode exigir JWTs emitidos pelo Clerk dos próprios clientes. Opções do cliente controlam limites de linhas e autocommit. Também está disponível como imagem Docker.

    O que oferece

    • pip install flight-sql-websocket-proxy ou uma imagem Docker
    • TLS no endpoint WebSocket e na conexão com o backend
    • Autenticação JWT Clerk para clientes do proxy
    • Controles de limite de linhas e autocommit
    Executar o proxy
    pip install flight-sql-websocket-proxy
    flight-sql-websocket-proxy-server --help
    #   --port INTEGER              Run the websocket server on this port.
    #   --tls CERTFILE KEYFILE      Enable transport-level security (TLS/SSL).
    #   --database-server-uri TEXT  The URI of the Arrow Flight SQL server.

    Apache-2.0.

    23Operações🚀 Novo

    Extensão DuckDB ADBC Scanner

    Consulte um servidor GizmoSQL remoto pelo DuckDB comum ou por outro servidor GizmoSQL, com a extensão Query.Farm.

    A extensão comunitária adbc_scanner do DuckDB, desenvolvida e mantida pela Query.Farm, permite conectar qualquer origem ADBC a uma sessão DuckDB local com ATTACH e consultá-la com SQL simples. Com o driver ADBC GizmoSQL carregado, tabelas remotas se comportam como locais: resultados são transmitidos ao DuckDB como Arrow sem cópias, a computação é enviada à origem quando suportada e dados remotos se combinam com arquivos locais em uma consulta.

    Como o GizmoSQL utiliza DuckDB internamente, a mesma extensão funciona no servidor GizmoSQL; uma instância pode federar consultas entre outras. As variantes -adbc da imagem Docker GizmoSQL incluem o driver pré-instalado.

    O que oferece

    • INSTALL adbc_scanner FROM community; LOAD adbc_scanner;
    • Conecte um servidor GizmoSQL com ATTACH, TYPE adbc e um segredo gizmosql
    • Transmissão Arrow sem cópias e execução na origem remota
    • Federação GizmoSQL para GizmoSQL com imagens -adbc
    SQL DuckDB
    INSTALL adbc_scanner FROM community;
    LOAD adbc_scanner;
    
    CREATE SECRET gizmosql_secret (
         TYPE adbc,
         SCOPE 'gizmosql://gizmosql.example.com:31337',
         driver 'gizmosql',
         uri 'gizmosql://gizmosql.example.com:31337',
         username 'your-user',
         password 'your-password'
     );
    
    ATTACH 'gizmosql://gizmosql.example.com:31337' AS gizmosql_db (TYPE adbc);

    A extensão adbc_scanner é um projeto Query.Farm (Apache-2.0); a GizmoData fornece o driver ADBC gizmosql carregado por ela.

    24Ferramentas🚀 Novo

    Plugin QGIS

    Adicione tabelas espaciais GizmoSQL ao QGIS como camadas vetoriais via Arrow Flight SQL.

    qgizmosql é um plugin QGIS que explora um servidor GizmoSQL e adiciona suas tabelas espaciais como camadas vetoriais. Diferentemente de um arquivo DuckDB local, os dados ficam em um servidor compartilhado, multiusuário, acessado por gRPC com TLS; a equipe GIS trabalha sobre uma única cópia governada dos dados.

    Usa o driver ADBC nativo 2.0, com senha ou OAuth/SSO no navegador, integra-se ao QGIS Auth Manager para armazenar credenciais e detecta automaticamente colunas GEOMETRY. Instale pelo repositório de plugins QGIS (experimental) ou pelo ZIP de lançamento.

    O que oferece

    • Tabelas GizmoSQL como camadas vetoriais QGIS
    • Login por senha ou OAuth/SSO, com suporte ao QGIS Auth Manager
    • Detecção automática de colunas GEOMETRY
    • Acesso multiusuário a um servidor espacial compartilhado
    Por qual integração do GizmoSQL devo começar?

    Para código, comece pelo driver ADBC (pip install adbc-driver-gizmosql): ele é a base nativa de todas as integrações Python desta página. O DBeaver 26.1 e posteriores já incluem GizmoSQL; basta selecioná-lo na lista de conexões. Para outros clientes SQL, como DataGrip e Tableau, use o driver JDBC. Para edição interativa, use GizmoSQL UI; para permitir consultas pelo Claude Desktop ou Claude Code, use o servidor MCP.

    Estas integrações funcionam com a edição gratuita GizmoSQL Core?

    Sim. Todas as integrações desta página se conectam ao GizmoSQL Core (Apache-2.0) e ao GizmoSQL Enterprise. Recursos da camada Enterprise, como login OAuth/SSO e permissões por catálogo, são ativados automaticamente ao conectar a um servidor Enterprise.

    Quais integrações oferecem login OAuth / SSO?

    O driver ADBC 2.0, o driver JDBC, os adaptadores dbt e SQLMesh, o backend Ibis e o GizmoSQL UI oferecem OAuth/SSO no navegador (auth_type: external) para servidores GizmoSQL Enterprise. As demais usam usuário e senha ou um token bearer JWT GizmoSQL.

    As integrações são de código aberto?

    Sim. Os drivers, adaptadores, plugins e clientes listados aqui são publicados pela GizmoData sob Apache-2.0 no GitHub, PyPI, npm, Maven Central, catálogo de plugins Grafana e repositório de plugins QGIS.

    Como conecto DBeaver, DataGrip, Tableau ou outra ferramenta JDBC?

    No DBeaver 26.1 ou posterior, escolha GizmoSQL em New Database Connection, e o DBeaver baixará o driver. Nas demais ferramentas, baixe o JAR do driver JDBC GizmoSQL, cadastre-o e conecte com uma URL no formato jdbc:gizmosql://host:31337?useEncryption=true. O driver aceita usuário/senha, token bearer e OAuth/SSO e requer JDK 17 ou mais recente.

    Como copio dados do Oracle, Snowflake ou PostgreSQL para o GizmoSQL?

    Use o adbc-replicate (pip install adbc-replicate). Você lista em um arquivo YAML os schemas, tabelas e views a copiar, e ele os transmite para o GizmoSQL como Arrow via ADBC, com colunas mascaradas avaliadas dentro da origem, snapshots consistentes e, nas execuções seguintes, cópia apenas das tabelas alteradas. As views são traduzidas para SQL do DuckDB. Execute-o pela linha de comando, pela imagem de contêiner ou pelo Helm chart, como um CronJob agendado do Kubernetes.

    Posso carregar PDFs no GizmoSQL e pesquisar seu texto?

    Sim. O PDF Loader (pip install gizmosql-pdf-loader) armazena cada PDF no GizmoSQL como metadados, blocos de arquivo de 8 MiB e uma linha de texto extraído por página, com OCR para páginas só de imagem. Cria search_pages() para correspondências de substrings e search_pages_ranked() para busca textual classificada por BM25; qualquer cliente SQL ou servidor MCP pode pesquisar os manuais e transmitir o arquivo original de volta.

    Posso consultar o GizmoSQL a partir do DuckDB comum?

    Sim. A extensão DuckDB ADBC Scanner permite que um processo DuckDB local consulte um servidor GizmoSQL remoto via Arrow Flight SQL com uma função de tabela, combinando dados remotos GizmoSQL e arquivos locais em uma única consulta DuckDB.

    Falta alguma integração?

    Tudo o que usa Apache Arrow Flight SQL, ADBC, JDBC ou ODBC já funciona com o GizmoSQL. Se sua ferramenta não estiver listada, conte para nós, e criaremos ou documentaremos a integração.

    Agende uma demonstração!Agendamento via Calendly