Exporter (0) Imprimer
Développer tout

USE FEDERATION (Base de données SQL Azure)

Mis à jour: avril 2014

Cette rubrique est obsolète. La version actualisée est disponible à la page Référence SQL 14 Transact-SQL. Consultez la rubrique USE FEDERATION.

ImportantImportant
La mise en œuvre actuelle des fédérations sera hors service avec les couches de service Web et Business. Envisagez de déployer des solutions de partitionnement personnalisées pour maximiser l'évolutivité, la souplesse et les performances. Pour plus d'informations sur le partitionnement personnalisé, consultez la rubrique Montée en puissance parallèle de bases de données SQL Azure.

Permet de se connecter à une fédération.

Conventions de syntaxe (Base de données SQL Azure)

USE FEDERATION ROOT
    WITH RESET


USE FEDERATION federation_name (distribution_name = value)
    WITH [FILTERING={ON|OFF},] RESET
[;]

ROOT
Fait pointer une connexion existante vers la racine de fédération. Si la connexion est établie à un membre de la fédération, la connexion à la base de données racine de la fédération est rétablie. Aucun effet n'est à noter lorsque la connexion est établie à une autre base de données.

federation_name
Nom de la fédération ciblée par la connexion.

distribution_name
Nom de la clé de fédération correspondant à cette fédération.

value
Valeur à utiliser pour se connecter au membre de la fédération. Le membre de fédération traitant la valeur de fédération devient le membre de fédération auquel la connexion est établie.

La valeur doit être conforme au type spécifié par la fédération dans le nom de fédération (federation_name) défini.

La valeur doit être différente de NULL.

WITH FILTERING=ON|OFF
Lorsque l'argument n'est pas présent, le filtrage est activé.

Lorsque FILTERING est désactivé (valeur OFF), la portée de la connexion est définie en fonction de la plage complète couverte par le membre de la fédération contenant la valeur clé spécifiée. La connexion se comporte comme si elle était établie au membre via son nom de membre de fédération physique (nom de base de données).

Le filtrage est désactivé (valeur OFF) lorsque des applications cherchent à utiliser toutes les données du membre de la fédération (p.ex., pour analyser la plage entière) et qu'elles intègrent déjà une logique pour traiter le filtrage sur une seule instance d'unité atomique de fédération atomique.

Lorsque FILTERING est activé (valeur ON), la portée de la connexion est définie en fonction de l'instance de clé de fédération d'un membre de la fédération et non de la plage complète de ce dernier. Dans ce mode, le processeur de requêtes ajoute à chaque requête qui fait référence à une table fédérée un prédicat (fed_column=value) de la colonne de fédération.

Le filtrage est activé (valeur ON) lorsque des applications cherchent à limiter automatiquement leur accès à une unité atomique de fédération atomique (p.ex., uniquement tenant_id 55).

WITH RESET
Il s'agit d'un mot clé requis qui rend la réinitialisation de connexion explicite.

L'instruction USE FEDERATION assure un comportement de regroupement de connexions efficace pour les bibliothèques de connectivité existantes en permettant aux applications de se connecter d'abord à la base de données qui contient l'objet de fédération et de basculer vers le membre de fédération spécifique via l'instruction USE FEDERATION. Cela est l'assurance que le pool de connexions client est plus petit que s'il devait gérer des membres de fédération individuels ou les valeurs unitaires atomiques de fédération.

USE FEDERATION peut être exécuté sur une connexion à n'importe quel moment de son existence, mais cette instruction doit être la seule du traitement et ne prend pas en charge le paramétrage.

USE FEDERATION rétablit une connexion entre le membre de fédération actuel ou la base de données racine et la racine de la fédération ou la valeur spécifiée dans un membre de la fédération. Lorsqu'une connexion est rétablie avec USE FEDERATION, la connexion est de nouveau établie. Par conséquent, tous les paramètres et le contexte existants de la connexion sont perdus. Cela revient à exécuter sp_reset_connection lorsqu'une connexion est extraite d'un pool de connexions.

Comme la base de données master ne peut pas contenir de fédération, l'exécution de USE FEDERATION ROOT dans la base de données master n'a aucun effet.

USE FEDERATION couplé à un nom de fédération qui n'existe pas retourne une erreur de type « La fédération <nom_fédération> n'existe pas ».

L'utilisation de FILTERING=ON permet de limiter la vue de la connexion à une seule instance de clé de fédération donnée. Une connexion à une instance de clé de fédération lie la requête à une unité atomique de fédération spécifique. Cela modifie la sémantique des requêtes émises au niveau de la connexion en introduisant un prédicat P. P est injecté pour toutes les tables fédérées dans une requête donnée en tant que Federation_Column =@filtering_value.

Toute requête qui tente de charger, insérer ou déplacer une ligne en dehors de la valeur de filtrage de fédération actuelle est non conforme et échouera, comme s'il existait une contrainte de validation au niveau de la table cible appliquant P.

WarningAvertissement
L'unité atomique de fédération n'est pas explicitement une limite de sécurité. Le processeur de requêtes ne garantit pas une absence totale de fuites d'informations entre les unités. Il est possible que les lignes situées en dehors de la plage soient partiellement traitées. Une logique scalaire arbitraire peut s'exécuter sur ces lignes, ce qui peut provoquer des exceptions inattendues, telles qu'un dépassement de capacité ou une division par zéro.

L'exemple suivant montre comment router la connexion à la racine de fédération.

using (SqlConnection connection = new SqlConnection(connectionString)) 
{ 
    connection.Open(); 
 
    using (SqlCommand command = connection.CreateCommand()) 
    { 
        // Route the connection to federation root 
        // Note that the CommandText should not contain any additional commends
        command.CommandText = "USE FEDERATION ROOT WITH RESET"; 
        command.ExecuteNonQuery(); 
    } 
}

Afficher:
© 2014 Microsoft