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.

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. Use o ODBC Manager para isso.

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 uma DSN, use o ODBC Manager ou edite o arquivo odbc.ini apropriado.

Criação de uma DSN usando o ODBC Manager

Para criar uma DSN no ODBC Gerente:

  1. Inicie o ODBC Manager.

  2. Clique em User DSN ou System DSN.

  3. Clique no botão Add.

  4. Selecione o driver que será utilizado (Snowflake) e clique em OK.

  5. Digite o nome da DSN e uma descrição (opcional).

  6. Crie um par palavra-chave/valor para cada parâmetro da DSN:

    1. Clique em Add para criar um par de palavra-chave/valor.

    2. Selecione Keyword e substitua pelo nome do parâmetro.

    3. Selecione Value e substitua pelo valor do parâmetro.

    Repita esse processo para cada parâmetro. 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.

  7. Clique em OK para criar o DSN.

Se você estiver criando a primeira DSN de usuário ou de sistema para o driver ODBC, o ODBC Manager criará o arquivo odbc.ini no diretório correspondente ao tipo de DSN que você está criando. Se você estiver criando DSNs adicionais, o ODBC Manager adicionará entradas para cada DSN ao arquivo odbc.ini existente.

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