Configuration de la connectivité PolyBase (Transact-SQL)
S’applique à : 
SQL Server 
Azure SQL Database Azure Synapse Analytics Analytics Platform System (PDW)
Affiche ou modifie les paramètres de configuration globale pour la connectivité PolyBase Hadoop et Stockage Blob Microsoft Azure.
Conventions de la syntaxe Transact-SQL
Syntaxe
Répertorier toutes les options de configuration.
sp_configure
[ ; ]
Configurer la connectivité Hadoop.
sp_configure [ @configname = ] 'hadoop connectivity' ,
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 }
[ ; ]
RECONFIGURE
[ ; ]
Arguments
[ @configname = ] 'option_name'
Nom d’une option de configuration. option_name est varchar(35) , avec NULL comme valeur par défaut. Si ce dernier n'est pas spécifié, la liste complète des options est renvoyée.
[ @configvalue = ] 'value'
Nouveau paramètre de configuration. value est de type int, avec NULL comme valeur par défaut. La valeur maximale dépend de l'option individuelle.
'hadoop connectivity'
Spécifie le type de source de données Hadoop pour toutes les connexions à partir de PolyBase vers des clusters Hadoop ou vers le Stockage Blob Azure. Pour plus d’informations, consultez CRÉER UNE SOURCE DE DONNÉES EXTERNES.
La liste suivante contient les paramètres de connectivité Hadoop et leurs sources de données Hadoop correspondantes prises en charge. Un seul paramètre peut être activé à la fois.
Les options 1, 4, 7 et 8 permettent de créer plusieurs types de sources de données externes et de les utiliser dans toutes les sessions sur le serveur.
Option 0 : désactiver la connectivité Hadoop
Option 1 : Hortonworks HDP 1.3 sur Windows Server
Option 1 : Azure Storage Blob (WASB[S])
Option n°2 : Hortonworks HDP 1.3 sur Linux
Option 3 : Cloudera CDH 4.3 sur Linux
Option 4 : Hortonworks HDP 2.0 sur Windows Server
Option 4 : Azure Storage Blob (WASB[S])
Option 5 : Hortonworks HDP 2.0 sur Linux
Option 6 : Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 et 5.13 sur Linux
Option 7 : Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 sur Linux
Option 7 : Hortonworks HDP 2.1, 2.2, 2.3, 2.4 sur Windows Server
Option 7 : Azure Storage Blob (WASB[S])
Option 8 : 1 Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Stockage Blob Azure (WASB[S]) et Azure Data Lake Storage Gen2 (ABFS[S])
1 Option 8 a été introduite avec SQL Server 2019 (15.x) CU 11.
Par défaut, la connectivité Hadoop est définie sur 0 (désactivée). Vous devez configurer la valeur de connectivité PolyBase Hadoop après avoir installé puis activé PolyBase. Pour plus d’informations, consultez Installer PolyBase sur Windows et Configurer PolyBase pour accéder à des données externes dans Hadoop.
RECONFIGURE
Met à jour la valeur d’exécution (run_value) pour qu’elle corresponde à la valeur de configuration (config_value). Consultez Jeux de résultats pour en savoir plus sur les définitions de run_value et config_value. La nouvelle valeur de configuration définie par sp_configure ne devient pas effective tant que la valeur d’exécution n’est pas définie par l’instruction RECONFIGURE . Après l’exécution de RECONFIGURE, vous devez arrêter et redémarrer le service SQL Server.
Important
Lors de l’arrêt du service SQL Server, les deux services supplémentaires s’arrêtent également automatiquement : le moteur PolyBase et le service de déplacement des données. Après le redémarrage du service Moteur SQL Server, démarrez manuellement ces deux services (car ils ne redémarreront pas automatiquement).
Valeurs des codes de retour
0 (réussite) or 1 (échec).
Jeu de résultats
Lorsqu’il est exécuté sans paramètres, sp_configure retourne un jeu de résultats à cinq colonnes.
| Nom de la colonne | Type de données | Description |
|---|---|---|
name |
nvarchar(35) | Nom de l'option de configuration. |
minimum |
int | Valeur minimale de l'option de configuration. |
maximum |
int | Valeur maximale de l'option de configuration. |
config_value |
int | Valeur définie à l’aide sp_configurede . |
run_value |
int | Valeur actuelle en cours d'utilisation par PolyBase. Cette valeur est définie en exécutant RECONFIGURE.Les config_value valeurs sont run_value généralement identiques, sauf si la valeur est en cours de modification.Un redémarrage peut être nécessaire pour obtenir une valeur d'exécution précise, si la reconfiguration est en cours. |
Notes
Dans SQL Server, après avoir exécuté RECONFIGURE, vous devez redémarrer SQL Server pour activer la connectivité Hadoop.
Dans Analytics Platform System (PDW), après avoir exécuté RECONFIGURE, vous devez redémarrer la région Analytics Platform System (PDW) pour activer la connectivité Hadoop.
Dans SQL Server 2022 (16.x) et versions ultérieures, Hadoop n’est plus pris en charge dans PolyBase.
Limites
RECONFIGURE n’est pas autorisé dans une transaction explicite ou implicite.
autorisations
Tous les utilisateurs peuvent s’exécuter sp_configure sans paramètres ni le paramètre @configname .
Nécessite une autorisation ALTER SETTINGS au niveau du serveur ou le rôle serveur fixe sysadmin pour changer une valeur de configuration ou pour exécuter RECONFIGURE.
Exemples
R. Liste de tous les paramètres de configuration disponibles
L'exemple suivant montre comment afficher toutes les options de configuration.
EXECUTE sp_configure;
Le résultat renvoie le nom de l'option suivi des valeurs minimales et maximales de cette option. Il config_value s’agit de la valeur utilisée par PolyBase lorsque la reconfiguration est terminée. Il run_value s’agit de la valeur actuellement utilisée. Les config_value valeurs sont run_value généralement identiques, sauf si la valeur est en cours de modification.
B. Liste des paramètres de configuration pour un nom de configuration
EXECUTE sp_configure @configname = 'hadoop connectivity';
C. Définir la connectivité Hadoop
Cet exemple définit PolyBase sur l’option 7. Cette option permet à PolyBase de créer et d’utiliser des tables externes sur Hortonworks HDP 2.1, 2.2 et 2.3 sur Linux et Windows Server, et le Stockage Blob Azure. Par exemple, SQL Server peut avoir 30 tables externes, dont 7 référencent des données sur Hortonworks HDP 2.1 sur Linux, 4 sur Hortonworks HDP 2.2 sur Linux, 7 sur Hortonworks HDP 2.3 sur Linux et les 12 autres références Stockage Blob Azure.
Ce code configure des tables externes pour référencer des données sur Hortonworks HDP 2.1, 2.2 et 2.3 sur Linux et Stockage Blob Azure.
EXECUTE sp_configure
@configname = 'hadoop connectivity',
@configvalue = 7;
GO
RECONFIGURE;
GO