Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL ServerSistema de Plataforma de Análise (PDW)
Exibe ou altera as definições de configuração global para a conectividade do PolyBase Hadoop e do Armazenamento de Blobs do Microsoft Azure.
Transact-SQL convenções de sintaxe
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
[ ; ]
Arguments
@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 Hadoop para todas as conexões do PolyBase para clusters Hadoop ou Armazenamento de Blob 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 Hadoop suportadas correspondentes. Apenas uma configuração pode estar em vigor de cada vez.
As opções 1, 4, 7 e 8 permitem que vários tipos de fontes de dados externas sejam criadas e usadas em todas as sessões no servidor.
Opção 0: Desativar a conectividade 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 no 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: 1 Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Azure Blob Storage (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 (desabilitada). Você deve configurar o valor de conectividade hadoop do PolyBase depois de instalar e habilitar o PolyBase. Para obter mais informações, consulte 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). Consulte Conjuntos de resultados para obter 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 RECONFIGURE instrução. Em seguida, depois de executar RECONFIGUREo , você deve parar e reiniciar o serviço do SQL Server.
Importante
Ao parar o serviço do SQL Server, os dois serviços adicionais também serão interrompidos automaticamente: PolyBase Engine e Data Movement Service. Depois de reiniciar o serviço de mecanismo do SQL Server, inicie manualmente esses dois serviços novamente, pois eles não serão iniciados automaticamente.
Valores de código de retorno
0 (sucesso) ou 1 (fracasso).
Conjunto de resultados
Quando executado sem parâmetros, sp_configure retorna um conjunto de resultados com cinco colunas.
| Nome da coluna | Tipo de dados | Description |
|---|---|---|
name |
Nvarchar(35) | 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 que foi definido usando sp_configure. |
run_value |
int | Valor atual em uso pelo PolyBase. Esse valor é definido executando RECONFIGURE.Os config_value e run_value são geralmente os mesmos, a menos que o valor esteja em processo de alteração.Uma reinicialização pode ser necessária antes que esse valor de execução seja preciso, se a reconfiguração estiver em andamento. |
Observações
No SQL Server, depois de executar RECONFIGUREo , para que o valor de execução da 'conectividade hadoop' entre em vigor, você precisa reiniciar o SQL Server.
No Analytics Platform System (PDW), depois de executar RECONFIGUREo , para que o valor de execução da 'conectividade hadoop' entre em vigor, você precisa reiniciar a região do Analytics Platform System (PDW).
No SQL Server 2022 (16.x) e versões posteriores, o Hadoop não é mais suportado no PolyBase.
Limitações
RECONFIGURE não é permitido em uma transação explícita ou implícita.
Permissions
Todos os usuários podem executar sp_configure sem parâmetros ou o parâmetro @configname .
Requer ALTER SETTINGS permissão no nível do servidor ou associação à função de servidor fixa sysadmin para alterar um valor de configuração ou executar RECONFIGUREo .
Examples
A. Listar todas as definições de configuração 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 config_value é o valor que o PolyBase usa quando a reconfiguração é concluída. O run_value é o valor que está sendo usado atualmente. Os config_value e run_value são geralmente os mesmos, a menos que o valor esteja em processo de alteração.
B. Listar as definições de configuração para um nome de configuração
EXECUTE sp_configure @configname = 'hadoop connectivity';
C. Definir conectividade Hadoop
Este exemplo define o PolyBase como 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 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.
Este código configura tabelas externas para fazer referência a 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