Uma linha · Todas as linguagens ADBC

    Instale os drivers ADBC da GizmoData

    Um comando instala um driver para todos os gerenciadores de drivers ADBC do seu computador: depois, Python, Go, Rust, R e C/C++ o carregam pelo nome. Sem sudo e sem bibliotecas cliente de fornecedores.

    Escolha um driver

    Execute a linha do seu sistema em um terminal. A linha para macOS e Linux funciona em qualquer shell POSIX; a do Windows roda no PowerShell 5.1 ou 7. Cada uma instala a versão mais recente.

    Apache-2.0

    Hardcharger, o servidor DuckDB 2.0 da GizmoData, por Chargewire, com as suas tags de consulta, configurações de sessão e login pelo navegador.

    Linux x86-64 e arm64, macOS com Apple silicon e Intel, Windows x64 e Arm64

    macOS e Linux
    curl https://install.adbc.gizmodata.com/hardcharger | sh
    Windows (PowerShell)
    irm https://install.adbc.gizmodata.com/hardcharger.ps1 | iex
    Só para Python, com pip
    pip install adbc-driver-hardcharger
    Apache-2.0

    Qualquer servidor que fale Chargewire, o protocolo HTTP aberto com resultados em Apache Arrow.

    Linux x86-64 e arm64, macOS com Apple silicon e Intel, Windows x64 e Arm64

    macOS e Linux
    curl https://install.adbc.gizmodata.com/chargewire | sh
    Windows (PowerShell)
    irm https://install.adbc.gizmodata.com/chargewire.ps1 | iex
    Só para Python, com pip
    pip install adbc-driver-chargewire
    Apache-2.0

    Servidores GizmoSQL, por Apache Arrow Flight SQL, com OAuth/SSO e detecção automática de DDL/DML.

    Linux x86-64 e arm64, macOS com Apple silicon e Intel, Windows x64 e Arm64

    macOS e Linux
    curl https://install.adbc.gizmodata.com/gizmosql | sh
    Windows (PowerShell)
    irm https://install.adbc.gizmodata.com/gizmosql.ps1 | iex
    Só para Python, com pip
    pip install adbc-driver-gizmosql

    Oracle Database, pelo próprio protocolo de rede TNS/TTC da Oracle. Sem as bibliotecas do Oracle Client: sem Instant Client, sem ORACLE_HOME, sem LD_LIBRARY_PATH.

    Linux x86-64 e arm64, macOS com Apple silicon, Windows x64 e Arm64

    macOS e Linux
    curl https://install.adbc.gizmodata.com/oracle | sh
    Windows (PowerShell)
    irm https://install.adbc.gizmodata.com/oracle.ps1 | iex
    Só para Python, com pip
    pip install adbc-driver-oracle
    MIT

    IBM Db2, pelo protocolo de rede DRDA. Sem o IBM CLI ou driver ODBC, sem db2jcc.

    Linux x86-64 e arm64, macOS com Apple silicon, Windows x64

    macOS e Linux
    curl https://install.adbc.gizmodata.com/db2 | sh
    Windows (PowerShell)
    irm https://install.adbc.gizmodata.com/db2.ps1 | iex
    Só para Python, com pip
    pip install adbc-driver-db2

    Um DuckDB 2.0 remoto, pelo protocolo Quack do DuckDB. Sem biblioteca do DuckDB no cliente.

    Linux x86-64 e arm64, macOS com Apple silicon, Windows x64 e Arm64

    macOS e Linux
    curl https://install.adbc.gizmodata.com/quack | sh
    Windows (PowerShell)
    irm https://install.adbc.gizmodata.com/quack.ps1 | iex
    Só para Python, com pip
    pip install adbc-driver-quack

    Não sabe o nome? O endereço sem um driver mostra a lista:

    curl https://install.adbc.gizmodata.com | sh

    Carregue pelo nome, em qualquer linguagem

    Depois da instalação, o nome do driver é tudo de que um gerenciador de drivers precisa. Estes exemplos carregam o driver Hardcharger e executam uma consulta em um servidor Hardcharger local; para outro driver, troque o nome e as opções de conexão.

    pip install adbc-driver-manager pyarrow
    1import adbc_driver_manager.dbapi as dbapi
    2
    3with dbapi.connect(
    4    driver="hardcharger",
    5    db_kwargs={
    6        "uri": "hardcharger://localhost?tls=false",
    7        "username": "hardcharger",
    8        "password": "change-me",
    9    },
    10) as conn:
    11    with conn.cursor() as cur:
    12        cur.execute(operation="SELECT 42 AS answer")
    13        print(cur.fetchone())  # (42,)

    Em C, defina os flags de carregamento como ADBC_LOAD_FLAG_DEFAULT, como acima: sem eles, o gerenciador de drivers não procura nos diretórios de drivers. O servidor destes exemplos também se instala com uma linha:

    Versões, opções e desinstalação

    Defina uma variável de ambiente para o script, ou passe opções depois de sh -s --. No PowerShell, defina a variável com $env: antes da linha do irm (ela continua definida pelo resto daquela sessão do PowerShell), ou execute o script como um script block e passe parâmetros, como faz a linha de desinstalação abaixo.

    Fixe uma versão
    curl https://install.adbc.gizmodata.com/hardcharger | ADBC_VERSION=2.6.1 sh
    # or
    curl https://install.adbc.gizmodata.com/hardcharger | sh -s -- --version 2.6.1
    $env:ADBC_VERSION = '2.6.1'; irm https://install.adbc.gizmodata.com/hardcharger.ps1 | iex
    Desinstalar
    curl https://install.adbc.gizmodata.com/hardcharger | sh -s -- --uninstall
    & ([scriptblock]::Create((irm https://install.adbc.gizmodata.com/hardcharger.ps1))) -Uninstall
    shPowerShellAmbienteO que faz
    --version <v>-Version <v>ADBC_VERSIONUma versão, 1.2.3 ou v1.2.3. O padrão é a versão mais recente.
    --dir <dir>-Dir <dir>ADBC_DIRInstala neste diretório de drivers em vez do seu (por exemplo, um que esteja no ADBC_DRIVER_PATH).
    --system—ADBC_SYSTEM=1Instala no diretório de drivers de todo o sistema (pode exigir sudo). Não no Windows, onde o nível do sistema é o registro.
    --name <name>-Name <name>ADBC_NAMEInstala com outro nome, lado a lado com outro driver de mesmo nome.
    --archive <file>-Archive <file>ADBC_ARCHIVEInstala um pacote da biblioteca que você já tem; nada é baixado.
    --base-url <url>-BaseUrl <url>ADBC_BASE_URLBaixa os arquivos da versão de um espelho.
    --uninstall-UninstallADBC_UNINSTALL=1Remove o driver: o manifesto e o diretório dele, nada mais.

    O que é instalado, e onde

    • A biblioteca compartilhada do driver, com a sua licença, da versão publicada do driver no GitHub, em uma pasta com o nome da versão. Instalar outra versão a substitui.
    • Um manifesto de driver, <name>.toml, com o caminho completo da biblioteca e o seu ponto de entrada. Os gerenciadores de drivers ADBC o procuram quando você pede um driver pelo nome.
    • Nada mais: nenhuma mudança no PATH, nos arquivos de inicialização do shell ou no registro.
    SistemaOs seus drivers (o padrão)Para todo o sistema (--system)
    Linux$XDG_CONFIG_HOME/adbc/drivers (~/.config/adbc/drivers)/etc/adbc/drivers
    macOS~/Library/Application Support/ADBC/Drivers/Library/Application Support/ADBC/Drivers
    Windows%LOCALAPPDATA%\ADBC\Drivers—

    O driver Hardcharger em um Mac

    ~/Library/Application Support/ADBC/Drivers/
    ├── hardcharger.toml
    └── hardcharger/
        ├── .adbc-install
        └── 2.6.1/
            ├── libadbc_driver_hardcharger.dylib
            ├── LICENSE
            ├── THIRD_PARTY_NOTICES
            └── hardcharger.toml.in

    O manifesto dele, hardcharger.toml

    # Written by https://install.adbc.gizmodata.com (https://github.com/gizmodata/adbc-install).
    # Load it by name: driver = "hardcharger" in any ADBC driver manager.
    manifest_version = 1
    
    name = 'Hardcharger'
    version = '2.6.1'
    publisher = 'GizmoData'
    license = 'Apache-2.0'
    url = 'https://github.com/gizmodata/hardcharger-adbc'
    
    [ADBC]
    version = '1.1.0'
    
    [Driver]
    entrypoint = 'AdbcDriverHardchargerInit'
    
    [Driver.shared]
    macos_arm64 = "/Users/you/Library/Application Support/ADBC/Drivers/hardcharger/2.6.1/libadbc_driver_hardcharger.dylib"

    Outro driver com o mesmo nome

    Se o driver de outro fornecedor já usa o nome, o nosso o substitui. O manifesto dele é guardado, com o nome <name>.toml.replaced-<time>, e o instalador mostra o comando que o restaura. Para manter os dois, instale o nosso com outro nome:

    curl https://install.adbc.gizmodata.com/hardcharger | sh -s -- --name gizmodata-hardcharger

    Verificado antes de ser instalado

    Checksums

    Cada pacote é conferido com o SHA256SUMS da versão, ou com o arquivo .sha256 do próprio pacote. Um checksum ausente ou diferente interrompe a instalação.

    O build certo

    O instalador escolhe a biblioteca para o seu sistema e processador, inclusive Apple silicon sob o Rosetta. No Linux é preciso glibc: Alpine e outros sistemas com musl são recusados com uma mensagem clara.

    Nunca pela metade

    O manifesto é gravado em um arquivo temporário e movido para o lugar em um só passo, então um gerenciador de drivers nunca lê um manifesto pela metade.

    Perguntas frequentes sobre a instalação

    Como instalo um driver ADBC da GizmoData?

    No macOS ou no Linux, execute curl https://install.adbc.gizmodata.com/hardcharger | sh, e no Windows execute irm https://install.adbc.gizmodata.com/hardcharger.ps1 | iex no PowerShell, trocando hardcharger pelo driver que você quer: hardcharger, chargewire, gizmosql, oracle, db2 ou quack. Não é preciso sudo. O driver vai para o seu próprio diretório de drivers ADBC, com um manifesto de driver, para que todo gerenciador de drivers ADBC da máquina o carregue pelo nome.

    O driver Oracle precisa das bibliotecas do Oracle Client?

    Não. O driver Oracle fala ele mesmo o protocolo de rede TNS/TTC da Oracle, em Go puro: sem Instant Client, sem ORACLE_HOME, sem LD_LIBRARY_PATH. É uma implementação independente, sem afiliação com a Oracle nem endosso dela.

    Quais linguagens podem usar os drivers?

    Qualquer linguagem com um gerenciador de drivers ADBC que leia manifestos de driver, entre elas Python (adbc-driver-manager), Go (drivermgr), Rust (adbc_driver_manager), R (adbcdrivermanager) e C/C++ (libadbc_driver_manager). Cada um encontra o driver pelo nome, por exemplo driver = "hardcharger".

    Qual é a licença dos drivers?

    Os drivers Hardcharger, Chargewire e GizmoSQL têm licença Apache-2.0; os drivers Oracle, Db2 e DuckDB Quack, MIT. Os seis são de código aberto, no GitHub.

    Como instalo uma versão específica?

    Defina ADBC_VERSION, por exemplo curl https://install.adbc.gizmodata.com/hardcharger | ADBC_VERSION=2.6.1 sh, ou passe --version 2.6.1 depois de sh -s --. No PowerShell, defina $env:ADBC_VERSION antes. O padrão é a versão mais recente.

    E se outro driver com o mesmo nome já estiver instalado?

    O instalador o substitui, depois de guardar o manifesto desse driver como <name>.toml.replaced-<time>. Ele mostra o que substituiu e o comando que o restaura. Para manter os dois, instale o nosso com outro nome, usando --name.

    O download é verificado?

    Sim. O instalador confere o arquivo da biblioteca com o SHA256SUMS da versão (ou com o arquivo .sha256 do próprio pacote) e se recusa a instalar quando o checksum falta ou não confere.

    Como desinstalo um driver?

    Execute a mesma linha com --uninstall: curl https://install.adbc.gizmodata.com/hardcharger | sh -s -- --uninstall. Ela remove o manifesto do driver e o diretório dele, e nada mais. No PowerShell, execute o script com -Uninstall: & ([scriptblock]::Create((irm https://install.adbc.gizmodata.com/hardcharger.ps1))) -Uninstall.

    Agora conecte-se a um servidor

    O Hardcharger no GizmoData Cloud é um servidor DuckDB 2.0 gerenciado com um clique na AWS, no Google Cloud ou no Azure, pronto para os drivers Hardcharger e Chargewire.

    Execute no GizmoData Cloud

    Oracle é marca registrada da Oracle e/ou de suas afiliadas. IBM e Db2 são marcas comerciais da International Business Machines Corporation. DuckDB é marca comercial da DuckDB Foundation. Os drivers da GizmoData são implementações independentes, sem afiliação com essas empresas nem endosso delas.

    Agende uma demonstração!Agendamento via Calendly