Reglas de nomenclatura (Azure AI Search)
En esta sección se explican las reglas de nomenclatura de Azure AI Search.
Gráfico de las reglas de nomenclatura
Las convenciones varían según el objeto debido a cómo se usan los objetos. Las reglas de nomenclatura de otros estándares se imponen en objetos específicos de Azure AI Search. Las direcciones URL y JSON tienen convenciones diferentes en términos de distinción entre mayúsculas y minúsculas, caracteres especiales y colocación de caracteres. Por necesidad, los objetos a los que se hace referencia en una dirección URL (nombre de host, ruta de acceso o cadena de consulta) o el cuerpo de la solicitud JSON deben seguir las convenciones de nomenclatura del estándar aplicable.
| Nombre | Length | Caso | Caracteres permitidos | Posición de carácter | Ejemplo |
|---|---|---|---|---|---|
| Servicio | 2 - 60 | Inferior | Letras, números, guiones (-) |
Primero, segundo y último caracteres deben ser una letra o un número. No hay guiones consecutivos en ningún lugar. |
contoso-srch1 |
| Índice | 2 - 128 | Inferior | Letras, números, guiones (-), caracteres de subrayado (_) |
El primer carácter debe ser una letra o un número. Sin guiones consecutivos ni caracteres de subrayado |
idx-hotels-2024 |
| Campo | 1 -128 | Mayúscula o minúscula | Letras, números, caracteres de subrayado (_) |
El primer carácter debe ser una letra. El nombre no puede comenzar con "azureSearch". |
Store_Name |
| Clave de documento | 1024 | Mayúscula o minúscula | Letras, números, guiones (-), caracteres de subrayado (_), signos iguales (=)Para las claves compuestas, se recomienda utilizar un guion, carácter de subrayado o signo igual como separador. Si las claves contienen otros símbolos, se recomienda codificarlas mediante una variante segura para direcciones URL de Base64. Por ejemplo, en .NET puede usar el método HttpServerUtility.UrlTokenEncode para este fin. |
El primer carácter no puede ser un carácter de subrayado. | RXhhbXBsZSBkb2N1bWVudCBrZXk= Cadena "Clave de documento de ejemplo" codificada en base 64. Se recomienda la codificación Base64 segura para direcciones URL porque a veces se usan claves de documento en la ruta de acceso url. La codificación le permite utilizar caracteres en una clave de documento que de lo contrario plantearían problemas en una dirección URL. |
| Perfil de puntuación | 1 - 128 | Mayúscula o minúscula | Letras, números, caracteres de subrayado (_) |
El primer carácter debe ser una letra o un número. | BoostFunc_TagsCustHist |
| Proveedor de sugerencias | 1 - 128 | Mayúscula o minúscula | Letras, números, caracteres de subrayado (_) |
El primer carácter debe ser una letra o un número. | Sugst01_Apparel |
| Origen de datos | 1 - 128 | Inferior | Letras, números, guiones (-) |
El primer y el último carácter deben ser una letra o un número. | docdbds-onlinecatalog-20240228 |
| indizador | 1 -128 | Inferior | Letras, números, guiones (-) |
El primer y el último carácter deben ser una letra o un número. | docbindxr-onlinecatalog-20240228 |
| Mapa de sinónimos | 1 -128 | Inferior | Letras, números, guiones (-) |
El primer y el último carácter deben ser una letra o un número. | custom-synonyms-2024 |
| Conjunto de aptitudes | 1 -128 | Inferior | Letras, números, guiones (-) |
El primer y el último carácter deben ser una letra o un número. | grok-myfiles-skillset-1 |