Partilhar via


Regras de nomenclatura (Azure AI Search)

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

Gráfico de regras de nomenclatura

As convenções variam consoante o objeto devido à forma como os objetos são utilizados. As regras de nomenclatura de outras normas são impostas a objetos específicos da Pesquisa de IA do Azure. Os URLs e o JSON têm diferentes convenções em termos de sensibilidade a maiúsculas e minúsculas, carateres especiais e colocação de carateres. Por necessidade, os objetos referenciados num URL (nome do anfitrião, caminho ou cadeia de consulta) ou corpo do pedido JSON têm de seguir as convenções de nomenclatura da norma aplicável.

Name Comprimento Caso Carateres permitidos Colocação de carateres Exemplo
Serviço 2 - 60 Mais baixo Letras, números, travessões (-) O primeiro, o segundo e o último carateres têm de ser uma letra ou um número.

Sem traços consecutivos em lado nenhum.
contoso-srch1
Índice 2 - 128 Mais baixo Letras, números, travessões (-), carateres de sublinhado (_) O primeiro caráter tem de ser uma letra ou um número.

Sem traços ou carateres de sublinhado consecutivos
idx-hotels-2024
Campo 1 -128 Superior ou inferior Letras, números, carateres de sublinhado (_) O primeiro caráter tem de ser uma letra.

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

Para chaves compostas, recomendamos que utilize um travessão, um caráter de sublinhado ou um sinal de igual como separador.

Se as chaves contiverem outros símbolos, recomendamos que os encodifice com uma variante segura de URL de Base64. Por exemplo, no .NET, pode utilizar o método HttpServerUtility.UrlTokenEncode para esta finalidade.
O primeiro caráter não pode ser um caráter de sublinhado. RXhhbXBsZSBkb2N1bWVudCBrZXk=

A cadeia "Exemplo de chave do documento" codificada na base 64. A codificação Base64 segura para URLs é recomendada porque, por vezes, as chaves de documento são utilizadas no caminho do URL. A codificação permite-lhe utilizar carateres numa chave de documento que, de outra forma, seria problemática num URL.
Perfil de classificação 1 - 128 Superior ou inferior Letras, números, carateres de sublinhado (_) O primeiro caráter tem de ser uma letra ou um número. BoostFunc_TagsCustHist
Sugestivo 1 - 128 Superior ou inferior Letras, números, carateres de sublinhado (_) O primeiro caráter tem de ser uma letra ou um número. Sugst01_Apparel
Origem de dados 1 - 128 Mais baixo Letras, números, travessões (-) O primeiro e o último caráter têm de ser uma letra ou um número. docdbds-onlinecatalog-20240228
Indexador 1 -128 Mais baixo Letras, números, travessões (-) O primeiro e o último caráter têm de ser uma letra ou um número. docbindxr-onlinecatalog-20240228
Mapa de sinónimos 1 -128 Mais baixo Letras, números, travessões (-) O primeiro e o último caráter têm de ser uma letra ou um número. custom-synonyms-2024
Conjunto de competências 1 -128 Mais baixo Letras, números, travessões (-) O primeiro e o último caráter têm de ser uma letra ou um número. grok-myfiles-skillset-1

Ver também