Instalação e configuração do driver ODBC para macOS

Semelhante ao Windows, o macOS utiliza fontes de dados nomeados (DSNs) para conectar aplicativos clientes baseados em ODBC ao Snowflake.

Neste tópico:

Pré-requisitos

Sistema operacional

Para obter uma lista dos sistemas operacionais compatíveis com os clientes Snowflake, consulte Suporte ao sistema operacional.

Com ODBC versão 3.0.1, o driver não suporta mais versões MacOS 10.14 e 10.15.

iODBC

O driver ODBC do Snowflake para Mac exige o iODBC, que está disponível para download em:

Para instalar o iODBC:

  1. Depois de baixar o iODBC, clique duas vezes no arquivo .dmg baixado.

  2. Clique duas vezes no arquivo do instalador, iODBC-SDK.pkg, e siga as instruções.

    Por padrão, o pacote instala o software no diretório /Library/Application Support/iODBC/bin. Você pode adicionar esse diretório à variável de ambiente $PATH para não precisar especificar o caminho completo para executar qualquer comando do iODBC.

Nota

O iODBC fornece uma ferramenta de administrador GUI para configurar drivers e DSNs. Entretanto, essa ferramenta não foi testada para uso com o Snowflake e, portanto, não deve ser usada para criar ou gerenciar DSNs.

Etapa 1: Instalar o driver ODBC

Para instalar o driver ODBC do Snowflake para macOS:

  1. Se ainda não tiver baixado o driver, faça o download agora. Para obter mais detalhes, consulte Download do driver ODBC.

  2. Clique duas vezes no arquivo .dmg baixado, snowflake_odbc_mac-<versão>.dmg.

  3. Clique duas vezes no arquivo do instalador, snowflakeODBC_<version>.pkg, e siga as instruções.

    Você provavelmente precisará informar a senha de administrador/sudo da máquina em que está instalando o driver.

Se você escolher o diretório padrão, o instalador vai instalar os arquivos do driver ODBC nos seguintes diretórios:

/opt/snowflake/snowflakeodbc

/Library/ODBC

Etapa 2: Configurar o driver ODBC

Para configurar o driver ODBC para macOS, crie uma ou mais fontes de dados (DSNs), que são armazenadas nos seguintes arquivos, dependendo do tipo de DSN que você criar:

  • DSNs de usuário: ~/Library/ODBC/odbc.ini

  • DSNs de sistema: /Library/ODBC/odbc.ini

Para criar um DSN, edite o arquivo odbc.ini apropriado.

Criação de uma DSN adicionando uma entrada ao arquivo odbc.ini

Se uma DSN de usuário ou de sistema já tiver sido criada para o driver, adicione a nova entrada ao arquivo odbc.ini que já existe no diretório correspondente ao tipo de DSN que você está criando. Se você estiver criando a primeira DSN do driver, você deve criar manualmente o arquivo odbc.ini e adicionar a entrada ao arquivo.

Para cada DSN, especifique:

  • Nome da DSN e do driver (Snowflake), no formato <nome_dsn> = <nome_driver>.

  • Caminho do diretório e nome do arquivo do driver, no formato Driver = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib.

  • Parâmetros de conexão, tais como server e uid (nome de login de usuário). Qualquer parâmetro de conexão que você adicionar à DSN não precisa ser especificado na cadeia de conexão do ODBC.

  • Parâmetros adicionais, tais como role, database e warehouse padrão.

Os parâmetros são especificados no formato <nome_parâmetro> = <valor>. Para obter mais detalhes sobre os parâmetros que podem ser definidos para cada DSN, consulte Parâmetros de configuração e conexão do ODBC.

O exemplo a seguir ilustra um arquivo odbc.ini que configura duas fontes de dados que utilizam formas diferentes de um identificador de conta no server URL:

  • testodbc1 usa um identificador de conta que usa um identificador de conta que especifica a conta myaccount na organização myorganization.

  • testodbc2 usa o localizador de conta xy12345 como identificador de conta.

    Note que testodbc2 utiliza uma conta no AWS na região Oeste dos US (Oregon). Se a conta estiver em uma região diferente ou se a conta usar um provedor de nuvem diferente, será necessário especificar segmentos adicionais após o localizador de conta.

    [ODBC Data Sources]
testodbc1 = Snowflake
testodbc2 = Snowflake


[testodbc1]
Driver      = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
Description =
uid         = peter
server      = myorganization-myaccount.snowflakecomputing.com
role        = sysadmin


[testodbc2]
Driver      = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
Description =
uid         = mary
server      = xy12345.snowflakecomputing.com
role        = analyst
database    = sales
warehouse   = analysis
    Copy

Observe o seguinte:

  • Ambos testodbc1 e testodbc2 têm funções padrão.

  • testodbc2 também tem um banco de dados e um warehouse padrão.

Etapa 3: Testar o driver ODBC

Você pode usar o utilitário de linha de comando iodbctest, fornecido com o iODBC para testar as DSNs criadas.

Quando solicitado pela cadeia de conexão do ODBC, insira os parâmetros de conexão necessários (nome da DSN, servidor, nome de login de usuário e senha), bem como qualquer outro parâmetro que você queira inserir na cadeia de conexão. A cadeia de conexão aceita parâmetros no formato <nome_do_parâmetro>=<valor>, por exemplo dsn=testodbc2, com cada parâmetro separado por um ponto e vírgula (;) e sem espaços em branco. Para ver a lista de parâmetros compatíveis, consulte Parâmetros de configuração e conexão do ODBC.

Nota

Se você definir o servidor e o nome de login de usuário na DSN, os únicos parâmetros necessários na cadeia de conexão serão o nome da DSN e a senha do usuário.

Por exemplo:

$ "/Library/Application Support/iODBC/bin/iodbctest"

iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.0607.1008

Enter ODBC connect string (? shows list): dsn=testodbc2;pwd=<password>

Dec 14 20:16:08 INFO  1299 SFConnection::connect: Tracing level: 4

Driver: 2.12.36 (Snowflake - Latest version supported by Snowflake: 2.12.38)

SQL>
Copy
Linguagem: Português