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.

Você pode baixar o iODBC de:

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. Abra o arquivo .dmg baixado, snowflake_odbc_mac-<versão>.dmg.

  3. Abra o arquivo do instalador, snowflakeODBC_<versão>.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 um 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 o nome da conta como um identificador para 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

You can use the iodbctest command-line utility provided with iODBC to test the DSNs you create.

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