Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Fonte de dicionário ODBC

View as MarkdownEdit this pageReport an issueSet up docs MCP

Você pode usar este método para se conectar a qualquer banco de dados que tenha um driver ODBC.

Exemplo de configurações:

SOURCE(ODBC(
    db 'DatabaseName'
    table 'SchemaName.TableName'
    connection_string 'DSN=some_parameters'
    invalidate_query 'SQL_QUERY'
    query 'SELECT id, value_1, value_2 FROM db_name.table_name'
))

Campos de configuração:

Configuração Descrição
db Nome do banco de dados. Omita-o se o nome do banco de dados estiver definido nos parâmetros de <connection_string>.
table Nome da tabela e do esquema, se existir.
connection_string String de conexão.
invalidate_query Consulta para verificar o status do dicionário. Opcional. Leia mais na seção Atualização de dados de dicionário usando LIFETIME.
background_reconnect Reconecta à réplica em segundo plano se a conexão falhar. Opcional.
query Consulta personalizada. Opcional.

O ClickHouse recebe os caracteres de aspas do driver ODBC e adiciona aspas a todas as configurações nas consultas enviadas ao driver, portanto é necessário definir o nome da tabela de acordo com o uso de maiúsculas e minúsculas no banco de dados.

Se você tiver problemas de codificação ao usar Oracle, consulte o item correspondente no FAQ.

Vulnerabilidade conhecida da funcionalidade de Dicionário ODBC

Exemplo de uso inseguro

Vamos configurar o unixODBC para PostgreSQL. Conteúdo de /etc/odbc.ini:

[gregtest]
Driver = /usr/lib/psqlodbca.so
Servername = localhost
PORT = 5432
DATABASE = test_db
#OPTION = 3
USERNAME = test
PASSWORD = test

Se você fizer uma consulta como

SELECT * FROM odbc('DSN=gregtest;Servername=some-server.com', 'test_db');

O ODBC Driver enviará os valores de USERNAME e PASSWORD do odbc.ini para some-server.com.

Exemplo de conexão com o PostgreSQL

Sistema operacional Ubuntu.

Instalação do unixODBC e do driver ODBC para PostgreSQL:

$ sudo apt-get install -y unixodbc odbcinst odbc-postgresql

Configurando o /etc/odbc.ini (ou ~/.odbc.ini se você fez login como um usuário que executa o ClickHouse):

    [DEFAULT]
    Driver = myconnection

    [myconnection]
    Description         = PostgreSQL connection to my_db
    Driver              = PostgreSQL Unicode
    Database            = my_db
    Servername          = 127.0.0.1
    UserName            = username
    Password            = password
    Port                = 5432
    Protocol            = 9.3
    ReadOnly            = No
    RowVersioning       = No
    ShowSystemTables    = No
    ConnSettings        =

A configuração do dicionário no ClickHouse:

CREATE DICTIONARY table_name (
    id UInt64,
    some_column UInt64 DEFAULT 0
)
PRIMARY KEY id
SOURCE(ODBC(connection_string 'DSN=myconnection' table 'postgresql_table'))
LAYOUT(HASHED())
LIFETIME(MIN 300 MAX 360)

Talvez seja necessário editar o odbc.ini para especificar o caminho completo da biblioteca com o driver DRIVER=/usr/local/lib/psqlodbcw.so.

Exemplo de conexão com o MS SQL Server

Sistema operacional: Ubuntu.

Instalação do driver ODBC para conexão ao MS SQL:

$ sudo apt-get install tdsodbc freetds-bin sqsh

Configurando o driver:

    $ cat /etc/freetds/freetds.conf
    ...

    [MSSQL]
    host = 192.168.56.101
    port = 1433
    tds version = 7.0
    client charset = UTF-8

    # test TDS connection
    $ sqsh -S MSSQL -D database -U user -P password

    $ cat /etc/odbcinst.ini

    [FreeTDS]
    Description     = FreeTDS
    Driver          = /usr/lib/x86_64-linux-gnu/odbc/libtdsodbc.so
    Setup           = /usr/lib/x86_64-linux-gnu/odbc/libtdsS.so
    FileUsage       = 1
    UsageCount      = 5

    $ cat /etc/odbc.ini
    # $ cat ~/.odbc.ini # if you signed in under a user that runs ClickHouse

    [MSSQL]
    Description     = FreeTDS
    Driver          = FreeTDS
    Servername      = MSSQL
    Database        = test
    UID             = test
    PWD             = test
    Port            = 1433

    # (optional) test ODBC connection (to use isql-tool install the [unixodbc](https://packages.debian.org/sid/unixodbc)-package)
    $ isql -v MSSQL "user" "password"

Observações:

  • para determinar a versão mais antiga do TDS com suporte em uma versão específica do SQL Server, consulte a documentação do produto ou veja MS-TDS Product Behavior

Configurando o dicionário no ClickHouse:

CREATE DICTIONARY test (
    k UInt64,
    s String DEFAULT ''
)
PRIMARY KEY k
SOURCE(ODBC(table 'dict' connection_string 'DSN=MSSQL;UID=test;PWD=test'))
LAYOUT(FLAT())
LIFETIME(MIN 300 MAX 360)
Navigation