CREATE ROUTE (Transact-SQL)

Syntaxe

CREATE ROUTE route_name
[ AUTHORIZATION owner_name ]
WITH  
   [ SERVICE_NAME = 'service_name', ]
   [ BROKER_INSTANCE = 'broker_instance_identifier' , ]
   [ LIFETIME = route_lifetime , ]
   ADDRESS =  'next_hop_address'
   [ , MIRROR_ADDRESS = 'next_hop_mirror_address' ]
[ ; ]

Arguments

• route_name
  Nom de la file d'attente à créer. Un nouvel itinéraire est créé dans la base de données active et détenu par le serveur principal spécifié dans la clause AUTHORIZATION. Vous ne pouvez pas spécifier les noms de serveur, base de données et schéma. L'argument route_name doit être d'un type sysname valide.

• AUTHORIZATION owner_name
  Définit le propriétaire de l'itinéraire pour l'utilisateur ou le rôle de base de données spécifié. owner_name peut correspondre au nom de n'importe quel utilisateur ou rôle valide lorsque l'utilisateur en cours est membre du rôle de base de données fixe db_owner ou du rôle serveur fixe sysadmin. Dans le cas contraire, owner_name doit être le nom de l'utilisateur actif, le nom d'un utilisateur pour lequel l'utilisateur actif possède l'autorisation IMPERSONATE, ou le nom d'un rôle auquel appartient l'utilisateur actif. Si cette clause est omise, l'itinéraire appartient à l'utilisateur en cours.

• WITH
  Introduit les clauses qui définissent l'itinéraire créé.

• SERVICE_NAME = 'service_name'
  Spécifie le nom du service distant vers lequel pointe cet itinéraire. Le paramètre service_name doit correspondre exactement au nom utilisé par le service distant. Service Broker utilise une comparaison octet par octet pour la concordance avec service_name. En d'autres termes, la comparaison respecte la casse et ne considère pas le classement actuel. Si la clause SERVICE_NAME est omise, cet itinéraire correspond à n'importe quel nom de service, mais la priorité affectée à la correspondance est inférieure à celle d'un itinéraire pour lequel la clause SERVICE_NAME est spécifiée. Un itinéraire dont le nom de service est « SQL/ServiceBroker/BrokerConfiguration » est un itinéraire vers un service de notification de la configuration de Service Broker. Un itinéraire vers ce service ne peut pas spécifier d'instance de Service Broker.

• BROKER_INSTANCE = 'broker_instance_identifier'
  Spécifie la base de données qui héberge le service cible. Le paramètre broker_instance_identifier doit être l'identificateur de l'instance Service Broker pour la base de données distante et peut être obtenu en exécutant la requête ci-après dans la base de données sélectionnée :

  SELECT service_broker_guid
  FROM sys.databases
  WHERE database_id = DB_ID()
  

  Si la clause BROKER_INSTANCE est omise, cet itinéraire correspond à n'importe quelle instance Service Broker. La priorité d'un itinéraire qui correspond à n'importe quelle instance de service Broker est plus élevée que celle d'un itinéraire pour lequel une instance service Broker explicite est spécifiée lorsque la conversation ne spécifie aucune instance Service Broker. Pour les conversations spécifiant une instance service Broker, la priorité d'un itinéraire pour lequel une instance Service Broker est spécifiée est plus élevée que celle d'un itinéraire qui correspond à n'importe quelle instance de Service Broker.

• LIFETIME **=**route_lifetime
  Spécifie la durée, en secondes, pendant laquelle SQL Server conserve l'itinéraire dans la table de routage. Lorsque la durée de vie expire, l'itinéraire expire et SQL Server n'en tient plus compte lors de la sélection d'un itinéraire pour une nouvelle conversation. Si cette clause est omise, route_lifetime est NULL et l'itinéraire n'expire jamais.

• ADDRESS ='next_hop_address'
  Spécifie l'adresse réseau pour cet itinéraire. Le paramètre next_hop_address spécifie une adresse TCP/IP au format suivant :

      TCP://{ nom_dns | nom_netbios | adresse_ip } ** :**numéro_port

  Le numéro_port spécifié doit correspondre au numéro de port du point de terminaison de Service Broker pour une instance SQL Server sur l'ordinateur spécifié. Cela peut être obtenu en exécutant la requête ci-après dans la base de données sélectionnée :

  SELECT tcpe.port
  FROM sys.tcp_endpoints AS tcpe
  INNER JOIN sys.service_broker_endpoints AS ssbe
     ON ssbe.endpoint_id = tcpe.endpoint_id
  WHERE ssbe.name = N'MyServiceBrokerEndpoint';
  

  Si le service est hébergé dans une base de données miroir, vous devez également spécifier la clause MIRROR_ADDRESS pour l'autre instance qui héberge une base de données miroir. Sinon, cet itinéraire ne bascule pas sur la base de données miroir.

  Si un itinéraire spécifie 'LOCAL' pour le paramètre next_hop_address, le message est remis à un service de l'instance actuelle de SQL Server.

  Si un itinéraire spécifie 'TRANSPORT' pour le paramètre next_hop_address, l'adresse réseau est déterminée en fonction de l'adresse réseau spécifiée dans le nom du service. Un itinéraire qui spécifie 'TRANSPORT' peut ne pas spécifier de nom de service ou d'instance Service Broker.

• MIRROR_ADDRESS ='next_hop_mirror_address'
  Spécifie l'adresse réseau d'une base de données miroir et d'une base de données miroir hébergée à l'adresse next_hop_address. Le paramètre next_hop_mirror_address spécifie une adresse TCP/IP au format suivant :

  TCP://{ nom_dns | nom_netbios | adresse_ip } ** :** numéro_port

  Le numéro_port spécifié doit correspondre au numéro de port du point de terminaison de Service Broker pour une instance SQL Server sur l'ordinateur spécifié. Cela peut être obtenu en exécutant la requête ci-après dans la base de données sélectionnée :

  SELECT tcpe.port
  FROM sys.tcp_endpoints AS tcpe
  INNER JOIN sys.service_broker_endpoints AS ssbe
     ON ssbe.endpoint_id = tcpe.endpoint_id
  WHERE ssbe.name = N'MyServiceBrokerEndpoint';
  

  Si la clause MIRROR_ADDRESS est spécifiée, l'itinéraire doit spécifier les clauses SERVICE_NAME et BROKER_INSTANCE. Un itinéraire qui spécifie 'LOCAL' ou 'TRANSPORT' pour le paramètre next_hop_address ne peut pas spécifier une adresse miroir.

Notes

La table de routage qui stocke les itinéraires est une table de métadonnées consultable via l'affichage catalogue sys.routes. Cet affichage catalogue peut être mis à niveau uniquement à l'aide des instructions CREATE ROUTE, ALTER ROUTE et DROP ROUTE.

Par défaut, la table de routage de chaque base de données utilisateur ne contient qu'un seul itinéraire. Cet itinéraire est nommé AutoCreatedLocal. L'itinéraire spécifie 'LOCAL' pour le paramètre next_hop_address et correspond à n'importe quel nom de service et identificateur d'instance de Service Broker.

Lorsqu'un itinéraire spécifie 'TRANSPORT' pour le paramètre next_hop_address, l'adresse réseau est déterminée en fonction du nom du service. SQL Server traite les noms de services qui commencent par une adresse réseau dans un format valide pour next_hop_address.

La table de routage peut contenir un nombre illimité d'itinéraires qui spécifient les mêmes service, adresse réseau et identificateur d'instance de Service Broker. Dans ce cas, Service Broker sélectionne un itinéraire à l'aide d'une procédure conçue pour rechercher la correspondance la plus précise entre les informations spécifiées dans la conversation et celles de la table de routage. Pour plus d'informations sur la sélection d'un itinéraire par Service Broker, consultez Routage Service Broker.

Service Broker ne supprime pas les itinéraires qui ont expiré de la table de routage. Un itinéraire expiré peut être activé à l'aide de l'instruction ALTER ROUTE.

Un itinéraire ne peut pas être un objet temporaire. Les noms d'itinéraires commençant par # sont autorisés, mais sont des objets permanents.

Autorisations

L'autorisation de création d'un itinéraire revient par défaut aux membres des rôles de base de données fixes db_ddladmin ou db_owner et aux membres du rôle serveur fixe sysadmin.

Exemples

A. Création d'un itinéraire TCP/IP à l'aide d'un nom DNS

CREATE ROUTE ExpenseRoute
    WITH
    SERVICE_NAME = '//Adventure-Works.com/Expenses',
    BROKER_INSTANCE = 'D8D4D268-00A3-4C62-8F91-634B89C1E315',
    ADDRESS = 'TCP://www.Adventure-Works.com:1234' ;

B. Création d'un itinéraire TCP/IP à l'aide d'un nom NetBIOS

CREATE ROUTE ExpenseRoute
    WITH 
    SERVICE_NAME = '//Adventure-Works.com/Expenses',
    BROKER_INSTANCE = 'D8D4D268-00A3-4C62-8F91-634B89C1E315',
    ADDRESS = 'TCP://SERVER02:1234' ;

C. Création d'un itinéraire TCP/IP à l'aide d'une adresse IP

CREATE ROUTE ExpenseRoute
    WITH
    SERVICE_NAME = '//Adventure-Works.com/Expenses',
    BROKER_INSTANCE = 'D8D4D268-00A3-4C62-8F91-634B89C1E315',
    ADDRESS = 'TCP://192.168.10.2:1234' ;

D. Création d'un itinéraire vers un Service Broker de transfert

CREATE ROUTE ExpenseRoute
    WITH
    ADDRESS = 'TCP://dispatch.Adventure-Works.com' ; 

E. Création d'un itinéraire vers un service local

CREATE ROUTE LogRequests
    WITH
    SERVICE_NAME = '//Adventure-Works.com/LogRequests',
    ADDRESS = 'LOCAL' ;

F. Création d'un itinéraire avec une durée de vie spécifique

CREATE ROUTE ExpenseRoute
    WITH
    SERVICE_NAME = '//Adventure-Works.com/Expenses',
    LIFETIME = 259200,
    ADDRESS = 'TCP://services.Adventure-Works.com:1234' ;

G. Création d'un itinéraire vers une base de données miroir

CREATE ROUTE ExpenseRoute
    WITH
    SERVICE_NAME = '//Adventure-Works.com/Expenses',
    BROKER_INSTANCE = '69fcc80c-2239-4700-8437-1001ecddf933',
    ADDRESS = 'TCP://services.Adventure-Works.com:1234', 
    MIRROR_ADDRESS = 'TCP://services-mirror.Adventure-Works.com:1234' ;

H. Création d'un itinéraire qui utilise le nom du service pour le routage

CREATE ROUTE TransportRoute
    WITH ADDRESS = 'TRANSPORT' ;

Voir aussi

Référence

Concepts