O driver ADBC do GizmoSQL
Um driver nativo desenvolvido em Go para GizmoSQL, via Apache Arrow Flight SQL. OAuth/SSO, detecção automática de DDL/DML e perfis de conexão — o mesmo núcleo em Python, Go, R, Rust, C#, C/C++ e JavaScript.
Um núcleo, todas as linguagens
Um único driver nativo baseado em Go atende a Python, Go, R, Rust, C#, C/C++ e JavaScript — com uma camada Python simples e compatível para substituição direta.
OAuth / SSO integrado
Autentique-se por qualquer provedor OIDC (Google, Okta, Entra ID) em um servidor GizmoSQL Enterprise — cada sessão corresponde a um usuário identificado.
Detecção automática de DDL/DML
O driver encaminha as instruções corretamente sem exigir que você indique consulta ou atualização, permitindo que ORMs e ferramentas funcionem via Arrow Flight SQL.
Uma API C. Todas as linguagens.
Os exemplos desta página estão em Python, mas ADBC expõe cada driver como uma biblioteca compartilhada compatível com C — o mesmo núcleo nativo funciona em Go, Rust, Java, C#, C/C++, JavaScript e outras linguagens. Um driver para toda arquitetura.
Comece a usar
Instale o driver e conecte-se ao seu servidor GizmoSQL — os resultados chegam como Apache Arrow, prontos para pandas, Polars ou DuckDB.
1# pip install adbc-driver-gizmosql
2import adbc_driver_gizmosql.dbapi as gizmosql
3
4with gizmosql.connect(
5 "gizmosql://gizmosql.example.com:31337", # TLS by default; ?transport=tcp for plaintext
6 username="user",
7 password="...",
8) as conn, conn.cursor() as cur:
9 cur.execute("SELECT * FROM sales ORDER BY amount DESC LIMIT 10")
10 for row in cur.fetchall():
11 print(row)Entre com SSO e carregue dados
Em um servidor GizmoSQL Enterprise, o driver autentica pelo seu provedor OIDC, e a ingestão em massa transmite Arrow diretamente para uma tabela.
OAuth / SSO
1# OAuth / SSO — authenticate through your OIDC provider (Enterprise)
2import adbc_driver_gizmosql.dbapi as gizmosql
3
4# auth_type="external" runs the browser SSO flow against the GizmoSQL server
5with gizmosql.connect(
6 "gizmosql://gizmosql.example.com:31337",
7 auth_type="external",
8) as conn, conn.cursor() as cur:
9 cur.execute("SELECT GIZMOSQL_USER()") # the authenticated user
10 print(cur.fetchone())Ingestão em massa
1# Automatic DDL/DML detection + bulk ingest — load Arrow straight into GizmoSQL
2import pyarrow as pa
3import adbc_driver_gizmosql.dbapi as gizmosql
4
5table = pa.table({"id": [1, 2, 3], "name": ["alice", "bob", "carol"]})
6with gizmosql.connect(uri, username="token", password=token) as conn, conn.cursor() as cur:
7 cur.adbc_ingest(table_name="customers", data=table, mode="create_append")
8 conn.commit()Um driver, um ecossistema inteiro
O núcleo adbc-driver-gizmosql é a base das integrações de ferramentas do GizmoSQL — o mesmo driver nativo é usado em todas elas.
Driver ADBC para GizmoSQL — perguntas frequentes
A qual banco de dados o driver ADBC do GizmoSQL se conecta?
Ao GizmoSQL — o servidor Apache Arrow Flight SQL de código aberto desenvolvido com DuckDB. Ele transmite resultados como lotes de registros Arrow via gRPC e adiciona recursos específicos do GizmoSQL, como OAuth/SSO e detecção automática de DDL/DML.
É compatível com o antigo driver Python?
Sim. A versão 2.x foi reescrita em Go com uma camada Python simples; o nome do pacote PyPI (adbc-driver-gizmosql) e a API são compatíveis byte a byte com a versão 1.x — atualizar exige apenas um comando pip.
Em quais linguagens posso utilizá-lo?
O núcleo nativo Go é exposto como uma biblioteca ADBC c-shared, utilizável em Python, Go, R, Rust, C#, C/C++ e JavaScript. O pacote Python é a forma mais comum de começar.
Há suporte a perfis de conexão?
Sim — perfis TOML reutilizáveis reúnem URI do servidor e opções com substituição por variáveis de ambiente; assim, as credenciais ficam fora do código, e você troca de ambiente alterando apenas o nome do perfil.
É gratuito?
Sim, o driver é de código aberto. O GizmoSQL Core (servidor) é Apache-2.0 e gratuito; o Enterprise adiciona SSO/OAuth, permissões e instrumentação por US$ 300/vCPU/ano.
