Règles de nommage (Recherche Azure AI)
Cette section explique les règles d’affectation de noms pour Azure AI Search.
Graphique des règles d'affectation des noms
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 respect de 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 ou chaîne de requête) ou un corps de requête JSON doivent suivre les conventions de nommage de la norme applicable.
| Nom | Longueur | Cas | Caractères autorisés | Positionnement des caractères | Exemple |
|---|---|---|---|---|---|
| Service | 2 - 60 | Moins grand | Lettres, chiffres, tirets (-) |
Le premier, le deuxième et le dernier caractères doivent être une lettre ou un nombre. 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 |
| Champ | 1 -128 | Majuscule ou minuscule | 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 | 1 024 | Majuscule ou minuscule | Lettres, chiffres, tirets (-), traits de soulignement (_), signes égaux (=)Pour les clés composées, nous recommandons d'utiliser un tiret, un trait de soulignement ou un signe égal en tant que séparateur. Si les clés contiennent d’autres symboles, nous vous recommandons de les encoder à l’aide d’une variante d’URL sécurisée de Base64. Par exemple, dans .NET, vous pouvez utiliser la méthode HttpServerUtility.UrlTokenEncode à cet effet. |
Le premier caractère ne peut pas être un trait de soulignement. | RXhhbXBsZSBkb2N1bWVudCBrZXk = Chaîne « Exemple de clé de document » encodée en base 64. L’encodage base64 sécurisé par URL est recommandé, car les clés de document sont parfois utilisées dans le chemin d’URL. L'encodage vous permet d'utiliser dans une clé de document des caractères qui seraient problématiques dans une URL. |
| Profils de calcul de score | 1 - 128 | Majuscule ou minuscule | Lettres, chiffres, traits de soulignement (_) |
Le premier caractère doit être une lettre ou un chiffre. | BoostFunc_TagsCustHist |
| Générateur de suggestion | 1 - 128 | Majuscule ou minuscule | 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 (-) |
Les premier et dernier caractères doivent être une lettre ou un chiffre. | docdbds-onlinecatalog-20240228 |
| Indexation | 1 -128 | Moins grand | Lettres, chiffres, tirets (-) |
Les premier et dernier caractères doivent être une lettre ou un chiffre. | docbindxr-onlinecatalog-20240228 |
| Carte de synonymes | 1 -128 | Moins grand | Lettres, chiffres, tirets (-) |
Les premier et dernier caractères doivent être une lettre ou un chiffre. | custom-synonyms-2024 |
| Ensemble de compétences | 1 -128 | Moins grand | Lettres, chiffres, tirets (-) |
Les premier et dernier caractères doivent être une lettre ou un chiffre. | grok-myfiles-skillset-1 |