Databricks OSS ODBC Driver

Importante

O controlador ODBC OSS da Databricks, versão 0.5.0, está em beta. Para obter informações sobre a versão 2.x de disponibilidade geral do controlador ODBC da Databricks, consulte a documentação do controlador ODBC da Databricks.

Para reportar um problema ou solicitar uma funcionalidade enquanto o driver está em Beta, contacte a equipa da Databricks responsável pela sua conta.

O Driver ODBC do Databricks OSS é um driver ODBC 3.8 para os armazéns SQL, Databricks e Lakehouse//RT . Foi concebido como uma substituição compatível do controlador ODBC do Databricks, versão 2.x, para as cargas de trabalho suportadas. As aplicações existentes, os DSNs e as cadeias de ligação que utilizam funcionalidades comuns da versão 2.x deverão, em geral, funcionar sem alterações.

Requirements

O Databricks OSS ODBC Driver e o Databricks ODBC Driver versão 2.x utilizam o mesmo nome registado do driver ODBC, identificadores de pacotes, caminhos de instalação e nomes de bibliotecas. Instalar uma versão sobre a outra substitui a instalação existente. Para mudar de driver, reinstala o pacote da versão que queres usar.

O controlador Databricks OSS ODBC é suportado nas seguintes plataformas:

Sistema Operativo Pacote e arquitetura Requisito
Windows MSI para x64 e x86 A arquitetura do driver deve corresponder à arquitetura da aplicação.
macOS Universal .pkg para Intel e Apple Silicon macOS 13.3 ou superior.
Linux .deb e .rpm para x86_64, aarch64 e i686 glibc 2.28 ou superior e um gestor de drivers ODBC compatível.

Também precisas do Nome do Host do Servidor e do Caminho HTTP para um SQL Databricks ou um armazém Lakehouse//RT. Consulte Obter detalhes de conexão para um recurso de computação do Azure Databricks.

Instale o Driver Databricks OSS ODBC

  1. No arquivo Databricks OSS ODBC Driver, descarregue a versão 0.5.0 do controlador Databricks OSS ODBC para o seu sistema operativo e arquitetura.
  2. Instale o pacote transferido:

    • No Windows, extrai o download e executa o MSI de 32 ou 64 bits. O instalador regista o Driver ODBC de Databricks com o Gestor de Controladores ODBC do Windows.

    • No macOS, execute DatabricksODBC-<version>-macOS.pkg.

    • No Linux, instala o pacote .deb ou .rpm e regista o driver no unixODBC:

      sudo odbcinst -i -d -f /opt/databricks/databricksodbc/Setup/odbcinst.ini

As bibliotecas de drivers estão instaladas nos mesmos locais da versão 2.x:

  • Windows 64 bits: C:\Program Files\Databricks ODBC Driver\lib\databricksodbc64.dll
  • Windows 32-bit:C:\Program Files (x86)\Databricks ODBC Driver\lib\databricksodbc32.dll
  • macOS: /Library/databricks/databricksodbc/lib/libdatabricksodbc.dylib
  • Linux 64-bit: /opt/databricks/databricksodbc/lib/64/libdatabricksodbc64.so
  • Linux 32-bit: /opt/databricks/databricksodbc/lib/32/libdatabricksodbc32.so

Configurar uma conexão

Começa pelo teu DSN 2.x ou cadeia de ligação existente. Propriedades comuns como Driver, Host, Port, HTTPPath, SSL, Catalog, e Schema são compatíveis. O controlador também aceita propriedades 2.x comuns que não são necessárias no respetivo transporte HTTP, para que as DSNs existentes possam ser reutilizadas.

Para criar um DSN ou uma cadeia de ligação sem DSN com estas definições, consulte Criar um DSN ODBC para o controlador ODBC do Databricks ou Criar uma cadeia de ligação ODBC sem DSN para o controlador ODBC do Databricks.

Para uma nova ligação, use as propriedades do exemplo seguinte. Para uma DSN, introduza os mesmos pares-chave-valor usando o gestor de drivers ODBC.

O exemplo seguinte utiliza a autenticação OAuth user-to-machine (U2M). As quebras de linha estão incluídas para maior legibilidade. Não os inclua na cadeia de ligação:

Driver=<path-to-driver>;
Host=<server-hostname>;
Port=443;
HTTPPath=<http-path>;
SSL=1;
AuthMech=11;
Auth_Flow=2;
Catalog=main;
Schema=default

Os seguintes métodos de autenticação são suportados:

Método de autenticação Properties
OAuth utilizador-para-máquina (U2M) AuthMech=11;Auth_Flow=2. PWD não é obrigatório. A cache persistente de tokens está ativada por defeito. Defina EnableTokenCache=0 para o desativar, ou defina TokenCachePassPhrase para usar uma palavra-passe ao encriptar a memória cache.
OAuth máquina para máquina (M2M) AuthMech=11;Auth_Flow=1;Auth_Client_ID=<client-id>;Auth_Client_Secret=<client-secret>.
Transmissão do token OAuth AuthMech=11;Auth_Flow=0;Auth_AccessToken=<oauth-token>.
Token de acesso pessoal do Azure Databricks AuthMech=3;UID=token;PWD=<personal-access-token>.

Migrar da versão 2.x

  1. Reveja as limitações conhecidas das funcionalidades utilizadas pela sua aplicação.
  2. Registe a versão 2.x instalada e faça backup dos seus DSNs, cadeias de ligação e ficheiros de configuração do driver.
  3. Instale o controlador ODBC do Databricks OSS.
  4. Reutilize o DSN existente ou a cadeia de ligação existente.
  5. Criação de ligações de teste, descoberta de metadados, instruções preparadas, ligação de parâmetros, cancelamento, recuperação de grandes resultados e fluxos de trabalho representativos de aplicações.

O controlador ODBC OSS da Databricks pode indicar nomes de tipos da Databricks mais específicos e a precisão e escala decimais declaradas do que a versão 2.x. Aplicações válidas que comparem valores de metadados exatamente.

Para reverter após a substituição de uma instalação, reinstale o pacote 2.x necessário e restaure a cópia de segurança da configuração.

Limitações conhecidas

As seguintes limitações aplicam-se enquanto o driver está em Beta:

  • O driver suporta armazéns Databricks SQL e Lakehouse//RT. Não suporta computação de uso geral.
  • O SQL é sempre enviado diretamente para o Azure Databricks. O driver não realiza a tradução SQL-92 disponível na versão 2.x. UseNativeQuery é aceite por motivos de compatibilidade, mas não altera o comportamento.
  • A execução assíncrona através de SQL_ATTR_ASYNC_ENABLE e SQLCompleteAsync não é suportada.
  • PUT, GET, e REMOVE operações para ficheiros em volumes do Catálogo Unity não são suportadas.
  • Parâmetros de entrada binários não são suportados.
  • As matrizes de parâmetros, incluindo no pyodbc fast_executemany valores de cadeia de caracteres e Unicode, são suportadas, mas o controlador envia um pedido de execução por linha.
  • Resultados grandes usam Cloud Fetch automaticamente e não podem ser forçados em linha. A obtenção de resultados suporta os tipos de dados do Databricks SQL, exceto FILE e OBJECT. Os valores complexos são devolvidos como texto.
  • Os proxies HTTPS suportam autenticação básica, mas não a autenticação Kerberos ou SPNEGO.
  • A configuração de revogação de certificados e as chaves privadas TLS mútuas encriptadas não são suportadas.
  • Algumas propriedades avançadas da versão 2.x não são suportadas. O controlador regista um aviso quando uma propriedade não é aplicada.
  • Última atualização a