Configurar o PolyBase para acessar dados externos com tipos genéricos ODBC

Aplica-se a:SQL Server

O PolyBase a partir do SQL Server 2019 permite que você se conecte a fontes de dados compatíveis com ODBC usando o conector ODBC. A partir do SQL Server 2025 (17.x), esta funcionalidade está disponível no Linux.

Este artigo demonstra como criar a configuração da conectividade usando uma fonte de dados ODBC. As orientações fornecidas usam um driver ODBC específico como exemplo. Consulte seu provedor ODBC para obter exemplos específicos. Consulte a documentação do driver ODBC para sua fonte de dados para determinar as opções de cadeia de conexão apropriadas. Os exemplos neste artigo podem não se aplicar a nenhum driver ODBC específico.

Pré-requisitos

• O PolyBase deve ser instalado e habilitado para sua instância do SQL Server instalação do PolyBase.

• Antes de criar uma credencial com escopo de banco de dados, você deve criar uma chave mestra.

Instale o driver ODBC

Siga as instruções de instalação do seu sistema operativo.

[MyDSN]
Driver = driver_name
Server = your_server_name
Database = your_database_name
Trusted_Connection = yes

[ODBC Drivers]
Devart ODBC Driver for ASE=installed
[Devart ODBC Driver for ASE]
Driver=/usr/share/devart/odbcase/libdevartodbcase.3.5.0.so

[ODBC Data Sources]
DEVART_ASE=Devart ODBC Driver for ASE
[DEVART_ASE]
Driver=Devart ODBC Driver for ASE
Data Source=database_server_ip
Port=5000
Database=master
QuotedIdentifier=1

Failed to bind port "127.0.0.1:25100"

Criar objetos dependentes no SQL Server

Para usar a fonte de dados ODBC, você deve primeiro criar alguns objetos para concluir a configuração.

Os seguintes comandos Transact-SQL são usados nesta seção:

• CRIAR CREDENCIAL COM ÂMBITO DE BASE DE DADOS
• CRIAR FONTE DE DADOS EXTERNA

1. Crie uma credencial com escopo de banco de dados para acessar a fonte ODBC.

   CREATE DATABASE SCOPED CREDENTIAL [<credential_name>]
       WITH IDENTITY = '<username>', SECRET = '<password>';
   

   Por exemplo, o exemplo a seguir cria uma credencial chamada credential_name, com uma identidade de username. Substitua <password> por uma senha complexa.

   CREATE DATABASE SCOPED CREDENTIAL credential_name
       WITH IDENTITY = 'username', SECRET = '<password>';
   

2. Crie uma fonte de dados externa com CREATE EXTERNAL DATA SOURCE.

   CREATE EXTERNAL DATA SOURCE [<external_data_source_name>]
   WITH (
       LOCATION = 'odbc://<ODBC server address>[:<port>]',
       CONNECTION_OPTIONS = 'Driver={<Name of installed driver>};
           ServerNode = <name of server  address>:<Port>',
       -- PUSHDOWN = [ON] | OFF,
       CREDENTIAL = [<credential_name>]
   );
   

   O exemplo a seguir cria uma fonte de dados externa:

   • Nomeado external_data_source_name
   • Localizado no ODBC SERVERNAME e na porta 4444
   • Conectando-se com o CData ODBC Driver For SAP 2015 - Este é o driver criado em Instalar o driver ODBC
   • Na porta ServerNodesap_server_node5555
   • Configurado para processamento delegado ao servidor (PUSHDOWN = ON)
   • Usando a credencial credential_name

   CREATE EXTERNAL DATA SOURCE external_data_source_name
   WITH (
       LOCATION = 'odbc://SERVERNAME:4444',
       PUSHDOWN = ON,
       CONNECTION_OPTIONS = 'Driver={CData ODBC Driver For SAP 2015};
           ServerNode = sap_server_node:5555',
       CREDENTIAL = credential_name
   );
   

Criar uma tabela externa

Depois de criar os objetos dependentes, você pode criar uma tabela externa usando T-SQL.

Os seguintes comandos Transact-SQL são usados nesta seção:

• CRIAR TABELA EXTERNA
• CRIAR ESTATÍSTICAS

1. Crie uma ou mais tabelas externas.

   Crie uma tabela externa. Você precisa fazer referência à fonte de dados externa criada anteriormente usando o DATA_SOURCE argumento e especificar a tabela de origem como .LOCATION Você não precisa fazer referência a todas as colunas, mas precisa garantir que os tipos sejam mapeados corretamente.

   CREATE EXTERNAL TABLE [<your_table_name>]
   (
       [<col1_name>] DECIMAL (38) NOT NULL,
       [<col2_name>] DECIMAL (38) NOT NULL,
       [<col3_name>] CHAR COLLATE Latin1_General_BIN NOT NULL
   )
   WITH (
       DATA_SOURCE = [<external_data_source_name>],
       LOCATION = '<sap_table_name>'
   );
   

   Observação

   Observação Você pode reutilizar os objetos dependentes para todas as tabelas externas usando essa fonte de dados externa.

2. Opcional: Criar estatísticas em uma tabela externa.

   Para um desempenho de consulta ideal, recomendamos a criação de estatísticas em colunas de tabelas externas, especialmente aquelas usadas para junções, filtros e agregações.

   CREATE STATISTICS statistics_name ON contact(FirstName) WITH FULLSCAN;
   

Conteúdo relacionado

• Virtualização de dados com o PolyBase no SQL Server
• Transact-SQL de referência do PolyBase