Partager via


Règles de nommage (Recherche Azure AI)

Cette section explique les règles de nommage pour Azure AI Search.

Tableau des règles de nommage

Les conventions varient d’un objet à l’autre en raison de la façon dont les objets sont utilisés. Les règles de nommage d’autres normes sont imposées à des objets Azure AI Search spécifiques. Les URL et JSON ont des conventions différentes en termes de sensibilité à la casse, de caractères spéciaux et de placement des caractères. Par nécessité, les objets référencés dans une URL (nom d’hôte, chemin d’accès ou chaîne de requête) ou dans le corps d’une requête JSON doivent respecter les conventions de nommage de la norme applicable.

Nom Length Cas Caractères autorisés Placement des personnages Example
Service 2 - 60 Moins grand Lettres, chiffres, tirets (-) Le premier, le deuxième et le dernier caractère doivent être une lettre ou un chiffre.

Pas de tirets consécutifs nulle part.
contoso-srch1
Index 2 - 128 Moins grand Lettres, chiffres, tirets (-), traits de soulignement (_) Le premier caractère doit être une lettre ou un chiffre.

Pas de tirets ou de traits de soulignement consécutifs
idx-hotels-2024
Terrain 1 -128 Supérieur ou inférieur Lettres, chiffres, traits de soulignement (_) Le premier caractère doit être une lettre.

Le nom ne peut pas commencer par « azureSearch ».
Store_Name
Clé de document 1024 Supérieur ou inférieur Lettres, chiffres, tirets (-), traits de soulignement (_), signes égaux (=)

Pour les touches composées, nous vous recommandons d’utiliser un tiret, un trait de soulignement ou un signe égal comme séparateur.

Si les clés contiennent d’autres symboles, nous vous recommandons de les coder à l’aide d’une variante de Base64 sécurisée pour les URL. Par exemple, dans .NET, vous pouvez utiliser la méthode HttpServerUtility.UrlTokenEncode à cette fin.
Le premier caractère ne peut pas être un trait de soulignement. RXhhbXBsZSBkb2N1bWVudCBrZXk=

La chaîne « Exemple de clé de document » encodée en base 64. L’encodage Base64 sécurisé pour les URL est recommandé, car les clés de document sont parfois utilisées dans le chemin d’accès à l’URL. L’encodage vous permet d’utiliser des caractères dans une clé de document qui seraient autrement problématiques dans une URL.
Profil de score 1 - 128 Supérieur ou inférieur Lettres, chiffres, traits de soulignement (_) Le premier caractère doit être une lettre ou un chiffre. BoostFunc_TagsCustHist
Suggesteur 1 - 128 Supérieur ou inférieur Lettres, chiffres, traits de soulignement (_) Le premier caractère doit être une lettre ou un chiffre. Sugst01_Apparel
Source de données 1 - 128 Moins grand Lettres, chiffres, tirets (-) Le premier et le dernier caractère doivent être une lettre ou un chiffre. docdbds-onlinecatalog-20240228
Indexer 1 -128 Moins grand Lettres, chiffres, tirets (-) Le premier et le dernier caractère doivent être une lettre ou un chiffre. docbindxr-onlinecatalog-20240228
Carte des synonymes 1 -128 Moins grand Lettres, chiffres, tirets (-) Le premier et le dernier caractère doivent être une lettre ou un chiffre. synonymes-personnalisés-2024
Ensemble de compétences 1 -128 Moins grand Lettres, chiffres, tirets (-) Le premier et le dernier caractère doivent être une lettre ou un chiffre. grok-myfiles-skillset-1

Voir aussi