Manipulation de données UDT
Transact-SQL ne fournit aucune syntaxe spécialisée pour les instructions INSERT, UPDATE ou DELETE lors de la modification de données dans des colonnes de type défini par l'utilisateur (UDT). Les fonctions Transact-SQL CAST ou CONVERT sont utilisées pour convertir des types de données natives en type UDT.
Insertion de données dans une colonne UDT
Les instructions Transact-SQL suivantes insèrent trois lignes d'exemples de données dans la table Points. Le type de données Point comprend des valeurs entières X et valeurs qui sont exposées en tant que propriétés du type UDT. Vous devez utiliser la fonction CAST ou CONVERT pour convertir les valeurs X et Y délimitées par des virgules en type Point. Les deux premières instructions utilisent la fonction CONVERT pour convertir une valeur de chaîne en type Point, et la troisième instruction utilise la fonction CAST :
INSERT INTO dbo.Points (PointValue) VALUES (CONVERT(Point, '3,4'));
INSERT INTO dbo.Points (PointValue) VALUES (CONVERT(Point, '1,5'));
INSERT INTO dbo.Points (PointValue) VALUES (CAST ('1,99' AS Point));
Sélection de données
L'instruction SELECT suivante sélectionne la valeur binaire du type UDT.
SELECT ID, PointValue FROM dbo.Points
Pour examiner la sortie affichée dans un format lisible, appelez la méthode ToString du type UDT Point qui convertit la valeur en sa représentation sous forme de chaîne.
SELECT ID, PointValue.ToString() AS PointValue
FROM dbo.Points;
Ce code produit les résultats suivants.
IDPointValue
----------
13,4
21,5
31,99
Vous pouvez également utiliser les fonctions Transact-SQL CAST et CONVERT pour obtenir les mêmes résultats.
SELECT ID, CAST(PointValue AS varchar)
FROM dbo.Points;
SELECT ID, CONVERT(varchar, PointValue)
FROM dbo.Points;
Le type UDT Point expose ses coordonnées X et Y en tant que propriétés, que vous pouvez ensuite sélectionner individuellement. L'instruction Transact-SQL suivante sélectionne les coordonnées X et Y séparément :
SELECT ID, PointValue.X AS xVal, PointValue.Y AS yVal
FROM dbo.Points;
Les propriétés X et Y retournent une valeur entière qui est affichée dans le jeu de résultats.
IDxValyVal
----------
134
215
3199
Utilisation de variables
Vous pouvez utiliser des variables à l'aide de l'instruction DECLARE pour attribuer une variable à un type UDT. Les instructions suivantes attribuent une valeur à l'aide de l'instruction Transact-SQL SET et affichent les résultats en appelant la méthode ToString du type UDT sur la variable :
DECLARE @PointValue Point;
SET @PointValue = (SELECT PointValue FROM dbo.Points
WHERE ID = 2);
SELECT @PointValue.ToString() AS PointValue;
Le jeu de résultats affiche la valeur de la variable :
PointValue
----------
-1,5
Les instructions Transact-SQL suivantes génèrent le même résultat en remplaçant SET par SELECT pour l'attribution de la variable :
DECLARE @PointValue Point;
SELECT @PointValue = PointValue FROM dbo.Points
WHERE ID = 2;
SELECT @PointValue.ToString() AS PointValue;
La différence entre SELECT et SET pour l'attribution de la variable réside dans le fait que SELECT vous permet d'attribuer plusieurs variables dans une instruction SELECT, tandis que la syntaxe SET nécessite que chaque attribution de variable possède sa propre instruction SET.
Comparaison de données
Vous pouvez utiliser des opérateurs de comparaison pour comparer des valeurs dans votre type UDT si vous avez attribuez à la propriété IsByteOrdered la valeur true lors de la définition de la classe. Pour plus d'informations, consultez Création d'un type défini par l'utilisateur.
SELECT ID, PointValue.ToString() AS Points
FROM dbo.Points
WHERE PointValue > CONVERT(Point, '2,2');
Vous pouvez comparer les valeurs internes du type UDT indépendamment du paramètre IsByteOrdered si les valeurs elles-mêmes sont comparables. L'instruction Transact-SQL suivante sélectionne des lignes où X est supérieur à Y :
SELECT ID, PointValue.ToString() AS PointValue
FROM dbo.Points
WHERE PointValue.X < PointValue.Y;
Vous pouvez également utiliser des opérateurs de comparaison avec des variables, comme indiqué dans cette requête que recherche un PointValue correspondant.
DECLARE @ComparePoint Point;
SET @ComparePoint = CONVERT(Point, '3,4');
SELECT ID, PointValue.ToString() AS MatchingPoint
FROM dbo.Points
WHERE PointValue = @ComparePoint;
Appel de méthodes UDT
Vous pouvez également appeler des méthodes qui sont définies dans votre type UDT dans Transact-SQL. La classe Point contient trois méthodes, Distance, DistanceFrom et DistanceFromXY. Pour obtenir les listes de code définissant ces trois méthodes, consultez Codage de types définis par l'utilisateur.
L'instruction Transact-SQL suivante appelle la méthode PointValue.Distance :
SELECT ID, PointValue.X AS [Point.X],
PointValue.Y AS [Point.Y],
PointValue.Distance() AS DistanceFromZero
FROM dbo.Points;
Les résultats sont affichés dans la colonne Distance :
IDXYDistance
------------------------
1345
2155.09901951359278
319999.0050503762308
La méthode DistanceFrom accepte un argument du type de données Point et affiche la distance du point spécifié au PointValue :
SELECT ID, PointValue.ToString() AS Pnt,
PointValue.DistanceFrom(CONVERT(Point, '1,99')) AS DistanceFromPoint
FROM dbo.Points;
Les résultats affichent les résultats de la méthode DistanceFrom pour chaque ligne dans la table :
ID PntDistanceFromPoint
---------------------
13,495.0210502993942
21,594
31,990
La méthode DistanceFromXY accepte individuellement les points en tant qu'arguments :
SELECT ID, PointValue.X as X, PointValue.Y as Y,
PointValue.DistanceFromXY(1, 99) AS DistanceFromXY
FROM dbo.Points
Le jeu de résultats est le même que la méthode DistanceFrom.
Mise à jour de données dans une colonne UDT
Pour mettre à jour des données dans une colonne UDT, utilisez l'instruction Transact-SQL UPDATE. Vous pouvez également utiliser une méthode du type UDT pour mettre à jour l'état de l'objet. L'instruction Transact-SQL suivante met à jour une ligne unique dans la table :
UPDATE dbo.Points
SET PointValue = CAST('1,88' AS Point)
WHERE ID = 3
Vous pouvez également mettre à jour des éléments UDT séparément. L'instruction Transact-SQL suivante met à jour uniquement la coordonnée Y :
UPDATE dbo.Points
SET PointValue.Y = 99
WHERE ID = 3
Si l'ordre d'octet du type UDT a la valeur true, Transact-SQL peut évaluer la colonne UDT dans une clause WHERE.
UPDATE dbo.Points
SET PointValue = '4,5'
WHERE PointValue = '3,4';
Mise à jour de limitations
Vous ne pouvez pas mettre à jour plusieurs propriétés à la fois à l'aide de Transact-SQL. Par exemple, l'instruction UPDATE suivante échoue avec une erreur parce que vous ne pouvez pas utiliser le même nom de colonne à deux reprises dans une instruction UDATE.
UPDATE dbo.Points
SET PointValue.X = 5, PointValue.Y = 99
WHERE ID = 3
Pour mettre à jour chaque point individuellement, vous devez créer une méthode mutateur dans l'assembly UDT Point. Vous pouvez ensuite appeler la méthode mutateur pour mettre à jour l'objet dans une instruction Transact-SQL UPDATE, comme suit :
UPDATE dbo.Points
SET PointValue.SetXY(5, 99)
WHERE ID = 3
Suppression de données dans une colonne UDT
Pour supprimer des données dans un type UDT, utilisez l'instruction Transact-SQL DELETE. L'instruction suivante supprime toutes les lignes dans la table qui correspondent aux critères spécifiés dans la clause WHERE. Si vous omettez la clause WHERE dans une instruction DELETE, toutes les lignes dans la table seront supprimées.
DELETE FROM dbo.Points
WHERE PointValue = CAST('1,99' AS Point)
Utilisez l'instruction UPDATE si vous souhaitez supprimer les valeurs dans une colonne UDT tout en laissant d'autres valeurs de lignes intactes. Cet exemple attribut la valeur null à PointValue.
UPDATE dbo.Points
SET PointValue = null
WHERE ID = 2