Compartilhar via


Regras de nomenclatura (Azure AI Search)

Esta seção explica as regras de nomenclatura do Azure AI Search.

Gráfico de regras de nomenclatura

As convenções variam de acordo com o objeto devido à forma como os objetos são usados. As regras de nomenclatura de outros padrões são impostas a objetos específicos do Azure AI Search. URLs e JSON têm convenções diferentes em termos de diferenciação de maiúsculas e minúsculas, caracteres especiais e posicionamento de caracteres. Por necessidade, os objetos referenciados em uma URL (nome do host, caminho ou cadeia de caracteres de consulta) ou corpo da solicitação JSON devem seguir as convenções de nomenclatura do padrão aplicável.

Nome Length Caso Caracteres permitidos Posicionamento do personagem Example
Service 2 - 60 Mais baixo Letras, números, traços (-) O primeiro, o segundo e o último caracteres devem ser uma letra ou número.

Sem traços consecutivos em qualquer lugar.
contoso-srch1
Index 2 - 128 Mais baixo Letras, números, traços (-), sublinhados (_) O primeiro caractere deve ser uma letra ou número.

Sem traços ou sublinhados consecutivos
idx-hotéis-2024
Campo 1 -128 Superior ou inferior Letras, números, sublinhados (_) O primeiro caractere deve ser uma letra.

O nome não pode começar com "azureSearch".
Store_Name
Chave do documento 1024 Superior ou inferior Letras, números, traços (-), sublinhados (_), sinais de igual (=)

Para chaves compostas, recomendamos usar um traço, sublinhado ou sinal de igual como separador.

Se as chaves contiverem outros símbolos, recomendamos codificá-las usando uma variante segura de URL de Base64. Por exemplo, no .NET, você pode usar o método HttpServerUtility.UrlTokenEncode para essa finalidade.
O primeiro caractere não pode ser um sublinhado. RXhhbXBsZSBkb2N1bWVudCBrZXk=

A string "Exemplo de chave de documento" codificada na base 64. A codificação Base64 segura para URL é recomendada porque as chaves de documento às vezes são usadas no caminho da URL. A codificação permite que você use caracteres em uma chave de documento que, de outra forma, seriam problemáticos em uma URL.
Perfil de pontuação 1 - 128 Superior ou inferior Letras, números, sublinhados (_) O primeiro caractere deve ser uma letra ou número. BoostFunc_TagsCustHist
Sugestor 1 - 128 Superior ou inferior Letras, números, sublinhados (_) O primeiro caractere deve ser uma letra ou número. Sugst01_Apparel
Fonte de dados 1 - 128 Mais baixo Letras, números, traços (-) O primeiro e o último caractere devem ser uma letra ou número. docdbds-onlinecatalog-20240228
Indexer 1 -128 Mais baixo Letras, números, traços (-) O primeiro e o último caractere devem ser uma letra ou número. docbindxr-onlinecatalog-20240228
Mapa de sinônimos 1 -128 Mais baixo Letras, números, traços (-) O primeiro e o último caractere devem ser uma letra ou número. sinônimos personalizados-2024
Conjunto de habilidades 1 -128 Mais baixo Letras, números, traços (-) O primeiro e o último caractere devem ser uma letra ou número. grok-myfiles-skillset-1

Consulte também