SET RECOMMENDATIONS (Transact-SQL)
S’applique à : 
Azure Synapse Analytics (pool SQL dédié uniquement)
Active ou désactive le conseiller de distribution Azure Synapse pour la session active. Pour obtenir des instructions et des exemples sur l’utilisation du conseiller de distribution, consultez Conseiller de distribution dans Azure Synapse SQL.
Notes
Le Conseiller de distribution est actuellement en préversion pour Azure Synapse Analytics. Les fonctionnalités d’évaluation sont destinées à des tests uniquement et ne doivent pas être utilisées sur des instances de production ou des données de production. En tant que fonctionnalité d’évaluation, le Conseiller de distribution est soumis à des modifications de comportement ou de fonctionnalité. Conservez également une copie de vos données de test si les données sont importantes.
Conventions de la syntaxe Transact-SQL
Syntaxe
SET RECOMMENDATIONS { ON | OFF };
Arguments
ACTIVÉ
Active le conseiller de distribution pour la session cliente active. Les requêtes exécutées ultérieurement seront prises en compte pour les recommandations de stratégie de distribution.
OFF
Désactive le conseiller de distribution pour la session cliente active. Retourne des conseils sous forme de chaîne.
Remarques
S'applique uniquement à Azure Synapse Analytics (pool SQL dédié uniquement).
Exécutez cette commande lorsque vous êtes connecté à une base de données utilisateur.
Autorisations
Nécessite l'appartenance au rôle public.
Exemples
L’exemple suivant retourne une recommandation de distribution sur les requêtes TPC-DS sélectionnées. TPC-DS est un point de référence standard pour les charges de travail de prise de décision analytique.
Commencez tout d’abord la collecte de recommandations du conseiller de distribution et exécutez des exemples de requêtes.
-- Step 1: Turn the distribution advisor ON for the current client session
SET RECOMMENDATIONS ON;
GO
-- <insert your queries here, up to 100>
SELECT ss_store_sk, COUNT(*) FROM store_sales, store WHERE ss_store_sk = s_store_sk GROUP BY ss_store_sk;
SELECT cs_item_sk, COUNT(*) FROM catalog_sales, item WHERE cs_item_sk = i_item_sk AND i_manufact_id > 100 GROUP BY cs_item_sk;
SELECT * FROM dbo.reason;
-- Turn the distribution advisor OFF for the current client session.
SET RECOMMENDATIONS OFF;
GO
Collectez des recommandations à partir de la vue sys.dm_pdw_distrib_advisor_results de gestion dynamique pour la session active. Par exemple :
-- Step 2: view advice generated for the above workload
DECLARE @sessionid nvarchar(100), @recommendation nvarchar(max);
SELECT @sessionid = SESSION_ID();
SELECT @recommendation = recommendation FROM sys.dm_pdw_distrib_advisor_results WHERE session_id = @sessionid;
SELECT @recommendation;
GO