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

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:

http://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/Downloads

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.

ODBC Manager — Opcional/Recomendado¶

O ODBC Manager é uma ferramenta GUI para configurar drivers e criar/gerenciar DSNs. A ferramenta é opcional porque você também pode criar DSNs manualmente editando o arquivo odbc.ini apropriado. O ODBC Manager está disponível em:

http://www.odbcmanager.net/

Para instalar o ODBC Manager:

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

2. Clique duas vezes no arquivo do instalador, ODBC Manager.pkg, e siga as instruções.

O instalador instala o ODBC Manager no diretório ~/Applications/Utilities.

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.