Configuração de conectividade do PolyBase (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System)

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

Liste todas as opções de configuração.

sp_configure
[ ; ]

Configure a conectividade do Hadoop.

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 [ = ] 'valor'

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 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 obter mais informações, consulte CREATE EXTERNAL DATA SOURCE.

A lista a seguir contém as configurações de conectividade do Hadoop e suas fontes de dados compatíveis com o Hadoop. 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])

1 A opção 8 foi introduzida com o SQL Server 2019 (15.x) 11.

Por padrão, a conectividade do Hadoop é definida como 0 (desativada). 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 se torna efetivo até que o valor de execução seja definido pela RECONFIGURE instrução. Após executar RECONFIGURE, você deve parar e reiniciar o serviço SQL Server.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Quando é executado sem parâmetros, o sp_configure retorna um conjunto de resultados com cinco colunas.

Comentários

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).

No SQL Server 2022 (16.x) e versões posteriores, o Hadoop não tem mais suporte no PolyBase.

Limitaçõ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.

EXECUTE sp_configure;

O resultado retorna o nome da opção seguido pelos valores mínimo e máximo da opção. O é o valor que o config_value PolyBase usa quando a reconfiguração é concluída. O run_value é o valor que está sendo usado no momento. Os config_value e run_value geralmente são os mesmos, a menos que o valor esteja em processo de alteração.

B. Listar as definições de configuração de um nome de configuração

EXECUTE 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 Server pode ter 30 tabelas externas, com 7 delas fazendo referência a dados no Hortonworks HDP 2.1 no Linux, 4 no Hortonworks HDP 2.2 no Linux, 7 no Hortonworks HDP 2.3 no Linux e as outras 12 fazendo referência ao Armazenamento de Blobs do Azure.

Esse código configura tabelas externas para referenciar dados no Hortonworks HDP 2.1, 2.2 e 2.3 no Linux e no Armazenamento de Blobs do Azure.

EXECUTE sp_configure
    @configname = 'hadoop connectivity',
    @configvalue = 7;
GO

RECONFIGURE;
GO

Conteúdo relacionado

• Virtualização de dados com o PolyBase no SQL Server
• sp_configure (Transact-SQL)
• CREATE EXTERNAL TABLE (Transact-SQL)
• CREATE EXTERNAL FILE FORMAT (Transact-SQL)
• CREATE EXTERNAL DATA SOURCE (Transact-SQL)