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 |