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

Consulte también