ALTER ASSEMBLY (Transact-SQL)

Mis à jour : 5 décembre 2005

Modifie un assembly en changeant les propriétés de catalogue SQL Server d'un assembly. ALTER ASSEMBLY le réactualise avec la dernière copie des modules Microsoft .NET Framework qui contiennent sa mise en œuvre et ajoute ou supprime les fichiers qui lui sont associés. Les assemblys sont créés à l'aide de CREATE ASSEMBLY.

Conventions de la syntaxe de Transact-SQL

Syntaxe

ALTER ASSEMBLY assembly_name
    [ FROM <client_assembly_specifier> | <assembly_bits> ]
    [ WITH <assembly_option> [ ,...n ] ]
    [ DROP FILE { file_name [ ,...n ] | ALL } ]
    [ ADD FILE FROM 
    { 
                client_file_specifier [ AS file_name ] 
      | file_bits AS file_name 
    } [,...n ] 
    ] [ ; ]
<client_assembly_specifier> :: =
        '\\computer_name\share-name\[path\]manifest_file_name'
  | '[local_path\]manifest_file_name'

<assembly_bits> :: =
    { varbinary_literal | varbinary_expression }

<assembly_option> :: =
    PERMISSION_SET = { SAFE | EXTERNAL_ACCESS | UNSAFE } 
  | VISIBILITY = { ON | OFF } ]
  | UNCHECKED DATA

Arguments

• assembly_name
  Nom de l'assembly que vous souhaitez modifier. assembly_name doit déjà exister dans la base de données.

• FROM <client_assembly_specifier> | <assembly_bits>
  Met à jour un assembly avec la dernière copie des modules .NET Framework qui contiennent sa mise en œuvre. Cette option ne peut être utilisée que s'il n'existe aucun fichier associé avec l'assembly spécifié.

  <client_assembly_specifier> spécifie l'emplacement réseau ou local où se trouve l'assembly actuellement réactualisé. L'emplacement réseau inclut le nom d'ordinateur, le nom de partage et un chemin d'accès au sein de ce partage. manifest_file_name spécifie le nom du fichier qui contient le manifeste de l'assembly.

  <assembly_bits> est la valeur binaire de l'assembly.

  Des instructions ALTER ASSEMBLY distinctes doivent être émises pour tous les assemblys dépendants qui requièrent aussi une mise à jour.

• PERMISSION_SET = { SAFE | EXTERNAL_ACCESS | UNSAFE }
  Spécifie la propriété de l'ensemble d'autorisation du code d'accès .NET Framework de l'assembly. Pour plus d'informations sur cette propriété, consultez CREATE ASSEMBLY (Transact-SQL).

• VISIBILITY = { ON | OFF }
  Indique si l'assembly est visible pour créer des fonctions, des procédures stockées, des déclencheurs, des types et des fonctions d'agrégation définis par l'utilisateur CLR (Common Language Runtime). Avec la valeur OFF, l'assembly ne peut être appelé que par d'autres assemblys. S'il existe des objets de base de données CLR créés sur l'assembly, sa visibilité ne peut pas être modifiée. Tout assembly référencé par assembly_name est téléchargé par défaut comme n'étant pas visible.

• UNCHECKED DATA
  Par défaut, ALTER ASSEMBLY échoue si elle doit vérifier la cohérence de lignes individuelles d'une table. Cette option permet de reporter les vérifications à une date ultérieure à l'aide de DBCC CHECKTABLE. Si cette option est spécifiée, SQL Server exécute l'instruction ALTER ASSEMBLY même si des tables de la base de données contiennent les éléments suivants :

  • des colonnes calculées persistantes qui référencent directement ou indirectement des méthodes dans l'assembly, par le biais de fonctions ou de méthodes Transact-SQL ;
  • des contraintes CHECK qui référencent directement ou indirectement des méthodes de l'assembly ;
  • des colonnes d'un type CLR défini par l'utilisateur qui dépendent de l'assembly, alors que ce type met en œuvre un format de sérialisation UserDefined (non Native) ;
  • des colonnes d'un type CLR défini par l'utilisateur qui font référence à des vues créées à l'aide de WITH SCHEMABINDING.

  S'il y a des contraintes CHECK, elles sont désactivées et signalées comme étant non approuvées. Les tables qui contiennent des colonnes dépendant de l'assembly sont signalées comme contenant des données non vérifiées jusqu'à ce que ces tables soient explicitement vérifiées.

  Seuls les membres des rôles de base de données fixes db_owner et db_ddlowner peuvent spécifier cette option.

  Pour plus d'informations, consultez Implémentation d'assemblys.

• [ DROP FILE { file_name[ ,...n] | ALL } ]
  Supprime le nom de fichier associé à l'assembly ou tous les fichiers associés à l'assembly, de la base de données. Si DROP FILE est utilisé avec ADD FILE qui suit, il s'exécute en premier. Cela vous permet de remplacer un fichier avec le même nom de fichier.

• [ ADD FILE FROM { client_file_specifier [ AS file_name] | file_bitsAS file_name}
  Télécharge un fichier à associer à l'assembly, par exemple un code source, des fichiers de débogage ou d'autres informations apparentées, sur le serveur et le rend visible dans l'affichage catalogue sys.assembly_files. client_file_specifier spécifie l'emplacement à partir duquel le fichier est téléchargé. file_bits peut être utilisé à la place pour spécifier la liste des valeurs binaires qui constituent le fichier. file_name spécifie le nom sous lequel le fichier doit être stocké dans l'instance de SQL Server. file_name doit être spécifié si file_bits l'est ; ce paramètre est facultatif si client_file_specifier est spécifié. Si file_name n'est pas spécifié, la partie du nom de fichier de client_file_specifier est utilisée comme file_name.

Notes

ALTER ASSEMBLY n'interrompt pas les sessions en cours qui exécutent du code dans l'assembly modifié. Ces sessions se terminent en utilisant les bits non modifiés de l'assembly.

Si la clause FROM est spécifiée, ALTER ASSEMBLY met à jour l'assembly par rapport aux dernières copies des modules fournis. Comme il peut y avoir dans l'instance de SQL Server des fonctions, des procédures stockées, des déclencheurs, des types de données et des fonctions d'agrégation définies par l'utilisateur CLR qui sont déjà définis dans l'assembly, l'instruction ALTER ASSEMBLY les réassocie à la dernière mise en œuvre de l'assembly. Pour cela, les méthodes qui effectuent le mappage avec les fonctions, les procédures stockées et les déclencheurs CLR doivent toujours exister dans l'assembly modifié, avec les mêmes signatures. Les classes qui mettent en œuvre des types et des fonctions d'agrégation CLR définis par l'utilisateur doivent toutefois satisfaire aux exigences inhérentes aux types ou agrégations définis par l'utilisateur.

Attention :

Si WITH UNCHECKED DATA n'est pas spécifié, SQL Server tente d'empêcher l'exécution de ALTER ASSEMBLY si la nouvelle version de l'assembly affecte des données existantes dans des tables, des index ou d'autres sites permanents. Cependant, SQL Server ne garantit pas la cohérence des colonnes, des vues indexées, des expressions ou des index calculés avec les routines et les types sous-jacents une fois que l'assembly CLR a été mis à jour. Soyez prudent lorsque vous exécutez ALTER ASSEMBLY pour vérifier qu'il n'existe pas de discordance entre le résultat d'une expression et une valeur basée sur la version de cette expression stockée dans l'assembly.

ALTER ASSEMBLY change la version de l'assembly. La culture et le jeton de clé publique de l'assembly restent inchangés.

L'instruction ALTER ASSEMBLY ne permet pas de modifier :

• Les signatures des fonctions, fonctions d'agrégation, procédures stockées et déclencheurs CLR d'une instance de SQL Server qui font référence à l'assembly. ALTER ASSEMBLY échoue lorsque SQL Server ne peut pas réassocier des objets de base de données .NET Framework de SQL Server avec la nouvelle version de l'assembly.
• Les signatures des méthodes de l'assembly qui sont appelées depuis d'autres assemblys.
• La liste des assemblys qui dépendent de l'assembly, référencés dans la propriété DependentList de l'assembly.
• La capacité d'indexation d'une méthode, à moins qu'il n'existe pas d'index ni de colonnes calculées persistantes dépendant de cette méthode, que ce soit directement ou indirectement.
• L'attribut du nom de méthode FillRow pour les fonctions table CLR.
• La signature de la méthode Accumulate et Terminate pour les agrégations définies par l'utilisateur.
• Assemblys système.
• Appartenance de l'assembly. Utilisez plutôt ALTER AUTHORIZATION (Transact-SQL).

Qui plus est, dans le cas des assemblys qui mettent en œuvre des types définis par l'utilisateur, vous pouvez utiliser ALTER ASSEMBLY pour apporter les modifications suivantes uniquement :

• Modification des méthodes publiques de la classe du type défini par l'utilisateur, tant que les signatures ou les attributs ne sont pas modifiés.
• Ajout de nouvelles méthodes publiques.
• Modification des méthodes privées de quelque manière que ce soit.

Les champs qui se trouvent dans un type défini par l'utilisateur sérialisé de façon native (notamment les membres de données ou les classes de base) ne peuvent pas être modifiés par le biais de ALTER ASSEMBLY. Aucune autre modification n'est prise en charge.

Si ADD FILE FROM n'est pas spécifié, ALTER ASSEMBLY supprime tous les fichiers associés à l'assembly.

Si l'instruction ALTER ASSEMBLY est exécutée sans la clause de données UNCHECKED, des vérifications sont effectuées pour s'assurer que la nouvelle version de l'assembly n'affecte pas les données existantes dans les tables. Selon la quantité de données à vérifier, cela peut affecter les performances.

Autorisations

Nécessite l'autorisation ALTER sur l'assembly. Il y a d'autres exigences :

• Pour modifier un assembly dont l'ensemble d'autorisations existantes est EXTERNAL_ACCESS, la connexion SQL Server doit avoir l'autorisation EXTERNAL ACCESS sur le serveur.
• Pour modifier un assembly dont l'ensemble d'autorisations existant est UNSAFE, il faut appartenir au rôle serveur fixe sysadmin.
• Pour modifier l'ensemble d'autorisations d'un assembly en faveur de EXTERNAL_ACCESS, la connexion SQL Server doit avoir l'autorisation EXTERNAL ACCESS ASSEMBLY sur le serveur.
• Pour modifier l'ensemble d'autorisations d'un assembly en faveur de UNSAFE, il faut appartenir au rôle serveur fixe sysadmin.
• Le fait de spécifier WITH UNCHECKED DATA nécessite d'être membre du rôle serveur fixe sysadmin.

Pour plus d'informations sur les ensembles d'autorisations d'un assembly, consultez Conception d'assemblys.

Exemples

A. Réactualisation d'un assembly

L'exemple suivant met à jour l'assembly ComplexNumber avec la dernière copie des modules .NET Framework qui conservent son implémentation.

Remarque :
L'assembly ComplexNumber peut être créé en exécutant les scripts d'exemple UserDefinedDataType. Pour plus d'informations, consultez Exemple de type de données défini par l'utilisateur.

ALTER ASSEMBLY ComplexNumber

FROM 'C:\Program Files\Microsoft SQL Server\90\Tools\Samples\1033\Engine\Programmability\CLR\UserDefinedDataType\CS\ComplexNumber\obj\Debug\ComplexNumber.dll'

B. Ajout d'un fichier à associer à un assembly

L'exemple suivant télécharge le fichier du code source Class1.cs à associer à l'assembly MyClass. Cet exemple suppose que l'assembly MyClass est déjà créé dans la base de données.

ALTER ASSEMBLY MyClass 
ADD FILE FROM 'C:\MyClassProject\Class1.cs';

C. Modification des autorisations d'un assembly

L'exemple suivant change l'ensemble d'autorisations de l'assembly ComplexNumber pour passer de SAFE à EXTERNAL ACCESS.

ALTER ASSEMBLY ComplexNumber WITH PERMISSION_SET = EXTERNAL_ACCESS

Voir aussi

Référence

CREATE ASSEMBLY (Transact-SQL)
DROP ASSEMBLY (Transact-SQL)
EVENTDATA (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications