Configuração de conectividade do PolyBase (Transact-SQL)
Aplica-se a: SQL Server Banco de Dados SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)
Exibe ou altera as definições de configurações globais para o PolyBase no Hadoop e a conectividade do Armazenamento de Blobs do Microsoft Azure.
Convenções de sintaxe de Transact-SQL
Sintaxe
--List all of the configuration options
sp_configure
[;]
--Configure Hadoop connectivity
sp_configure [ @configname = ] 'hadoop connectivity',
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 }
[;]
RECONFIGURE
[;]
Argumentos
[ @configname= ] 'option_name'
É o nome de uma opção de configuração. option_name é varchar(35) , com um padrão de NULL
. Se não for especificado, a lista completa de opções será retornada.
[ @configvalue= ] 'value'
É a nova definição de configuração. value é int, com um padrão de NULL
. O valor máximo depende da opção individual.
'conectividade do hadoop'
Especifica o tipo de fonte de dados do Hadoop para todas as conexões do PolyBase com clusters do Hadoop ou com o Armazenamento de Blobs do Azure. Para saber mais, confira CREATE EXTERNAL DATA SOURCE (Transact-SQL).
Estas são as configurações de conectividade do Hadoop e suas fontes de dados Hadoop com suporte correspondentes. Somente uma configuração pode estar em vigor por vez.
As opções 1, 4, 7 e 8 permitem a criação e uso de vários tipos de fontes de dados externas em todas as sessões no servidor.
Opção 0: Desabilitar a conectividade do Hadoop
Opção 1: Hortonworks HDP 1.3 no Windows Server
Opção 1: Armazenamento de Blobs do Azure (WASB[S])
Opção 2: Hortonworks HDP 1.3 no Linux
Opção 3: Cloudera CDH 4.3 em Linux
Opção 4: Hortonworks HDP 2.0 no Windows Server
Opção 4: Armazenamento de Blobs do Azure (WASB[S])
Opção 5: Hortonworks HDP 2.0 no Linux
Opção 6: Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 e 5.13 no Linux
Opção 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 no Linux
Opção 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4 no Windows Server
Opção 7: Armazenamento de Blobs do Azure (WASB[S])
Opção 8:* Hortonworks HDP 3,1, Cloudera CDH 6,1, 6,2, 6,3, Armazenamento de Blobs do Azure (WASB [S]) e Azure Data Lake Storage Gen2 (ABFS[S])
* A opção 8 introduzida com o SQL Server 2019 CU11.
Por padrão, a conectividade de Hadoop é definida como 0 (desabilitada). Você deve configurar o valor de conectividade do Hadoop do PolyBase depois de instalar e habilitar o PolyBase. Para saber mais, confira Instalar o PolyBase no Windows e Configurar o PolyBase para acessar dados externos no Hadoop.
RECONFIGURE
Atualiza o valor de execução (run_value
) para corresponder ao valor de configuração (config_value
). Confira os Conjuntos de Resultados para ver as definições de run_value
e config_value
. O novo valor de configuração definido por sp_configure
não entra em vigor até que o valor de execução seja definido pela instrução RECONFIGURE
. Após executar RECONFIGURE
, você deve parar e reiniciar o serviço SQL Server.
Importante
Observe que ao interromper o serviço SQL Server, o Mecanismo PolyBase e o Serviço de Movimentação de Dados adicionais serão interrompidos automaticamente. Depois de reiniciar o serviço do mecanismo SQL Server, reinicie manualmente esses dois serviços novamente, pois eles não serão iniciados automaticamente.
Valores do código de retorno
0 (êxito) ou 1 (falha)
Conjuntos de resultados
Quando é executado sem parâmetros, o sp_configure
retorna um conjunto de resultados com cinco colunas.
Nome da coluna | Tipo de dados | Descrição |
---|---|---|
name | nvarchar(35) | O nome da opção de configuração. |
minimum | int | Valor mínimo da opção de configuração. |
maximum | int | Valor máximo da opção de configuração. |
config_value | int | Valor definido usando sp_configure. |
run_value | int | O valor atual que está sendo usado pelo PolyBase. Esse valor é definido pela execução de RECONFIGURE. Normalmente, config_value e run_value são os mesmos, a menos que o valor esteja sendo alterado. Talvez seja necessário reinicializar antes que esse valor de execução seja preciso, caso a reconfiguração esteja em andamento. |
Comentários gerais
Após a execução de RECONFIGURE
no SQL Server, para que o valor de execução de 'conectividade do hadoop' entre em vigor, é necessário reiniciar SQL Server.
Após a execução de RECONFIGURE
no PDW (Analytics Platform System), para que o valor de execução de 'conectividade do hadoop' entre em vigor, é necessário reiniciar a região PDW (Analytics Platform System).
A partir do SQL Server 2022 (16.x), o Hadoop não é mais compatível com o PolyBase.
Limitações e restrições
RECONFIGURE não é permitido em uma transação explícita ou implícita.
Permissões
Todos os usuários podem executar sp_configure
sem parâmetros ou com o parâmetro @configname.
É necessária a permissão no nível do servidor ALTER SETTINGS
ou a associação à função de servidor fixa sysadmin para alterar um valor de configuração ou para executar RECONFIGURE
.
Exemplos
a. Listar todas as configurações disponíveis
O exemplo a seguir mostra como listar todas as opções de configuração.
EXEC sp_configure;
O resultado retorna o nome da opção seguido pelos valores mínimo e máximo da opção. O config_value será o valor usado pelo PolyBase após a conclusão da reconfiguração. O run_value é o valor que está sendo usado. Normalmente, config_value e run_value são os mesmos, a menos que o valor esteja sendo alterado.
B. Listar as definições de configuração de um nome de configuração
EXEC sp_configure @configname='hadoop connectivity';
C. Definir a conectividade do Hadoop
Este exemplo define PolyBase para a opção 7. Essa opção permite que o PolyBase crie e use tabelas externas no Hortonworks HDP 2.1, 2.2 e 2.3 no Linux e no Windows Server e no Armazenamento de Blobs do Azure. Por exemplo, o SQL pode ter 30 tabelas externas, com sete delas fazendo referência a dados no Hortonworks HDP 2.1 no Linux, quatro no Hortonworks HDP 2.2 no Linux, sete no Hortonworks HDP 2.3 no Linux e os outras 12 fazendo referência ao Armazenamento de Blobs do Azure.
--Configure external tables to reference data on Hortonworks HDP 2.1, 2.2, and 2.3 on Linux, and Azure Blob Storage
sp_configure @configname = 'hadoop connectivity', @configvalue = 7;
GO
RECONFIGURE
GO