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
--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
[;]
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.
'connectivité hadoop'
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 la rubrique CREATE EXTERNAL DATA SOURCE (Transact-SQL),
Voici les paramètres de connectivité Hadoop et leurs sources de données Hadoop prises en charge correspondantes. 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 :* 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])
* Option 8 introduite dans SQL Server 2019 CU11.
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 n’est pas effective tant que la valeur d’exécution n’a pas été 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
Notez que lors de l’arrêt du service SQL Server, les deux services supplémentaires (Moteur et Mouvement de données PolyBase) s’arrêteront automatiquement. 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) ou 1 (échec)
Jeux 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 qui avait été définie à l’aide de sp_configure. |
| run_value | int | Valeur actuelle en cours d'utilisation par PolyBase. Cette valeur est définie en exécutant RECONFIGURE. Les valeurs config_value et run_value sont 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. |
Remarques générales
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.
Depuis SQL Server 2022 (16.x), Hadoop n’est plus pris en charge dans PolyBase.
Limitations et restrictions
RECONFIGURE n'est pas autorisée dans une transaction explicite ou implicite.
Autorisations
Tous les utilisateurs peuvent exécuter sp_configure sans paramètres ou avec 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.
EXEC sp_configure;
Le résultat renvoie le nom de l'option suivi des valeurs minimales et maximales de cette option. config_value est la valeur que PolyBase utilisera une fois la reconfiguration terminée. run_value est la valeur en cours d’utilisation. Les valeurs config_value et run_value sont 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
EXEC 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 peut avoir 30 tables externes dont 7 référencent des données sur Hortonworks HDP 2.1 dans Linux, 4 sur Hortonworks HDP 2.2 dans Linux, 7 sur Hortonworks HDP 2.3 dans Linux, et les 12 autres référençant le Stockage Blob 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
Étapes suivantes
Commentaires
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez : https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour