Partager via


CRYPT_GEN_RANDOM (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de données SQL dans Microsoft Fabric

Cette fonction retourne un nombre aléatoire de chiffrement généré par l'API Crypto (CAPI). CRYPT_GEN_RANDOM retourne un nombre hexadécimal avec une longueur d’un nombre spécifié d’octets.

Conventions de la syntaxe Transact-SQL

Syntaxe

CRYPT_GEN_RANDOM ( length [ , seed ] )   

Arguments

length
La longueur, en octets, du nombre que CRYPT_GEN_RANDOM va créer. L’argument length comporte un type de données int et une plage de valeurs comprises entre 1 et 8000. CRYPT_GEN_RANDOM retourne la valeur NULL pour une valeur int en dehors de cette plage.

seed
Un nombre hexadécimal facultatif à utiliser comme valeur de départ aléatoire. La longueur de la valeur seed doit correspondre à la valeur de l’argument length. L’argument seed comporte un type de données varbinary(8000).

Types retournés

varbinary(8000)

Autorisations

Cette fonction est publique et ne requiert pas d'autorisation spéciale.

Exemples

R. Génération d'un nombre aléatoire

Cet exemple génère un nombre aléatoire d’une longueur de 50 octets :

SELECT CRYPT_GEN_RANDOM(50) ;  

Cet exemple génère un nombre aléatoire d'une longueur de 4 octets à l'aide d'une valeur de départ de 4 octets :

SELECT CRYPT_GEN_RANDOM(4, 0x25F18060) ;  

Voir aussi

RAND (Transact-SQL)