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 | Comprimento | Caixa | Caracteres permitidos | Posicionamento de caracteres | Exemplo |
|---|---|---|---|---|---|
| Serviço | 2 - 60 | Inferior | Letras, números, traços (-) |
Primeiro, segundo e último caracteres devem ser uma letra ou um número. Sem traços consecutivos em qualquer lugar. |
contoso-srch1 |
| Índice | 2 - 128 | Inferior | Letras, números, traços (-), sublinhados (_) |
O primeiro caractere deve ser uma letra ou número. Sem traços ou sublinhados consecutivos |
idx-hotels-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 de documento | 1024 | Superior ou inferior | Letras, números, traços (-), sublinhados (_), sinais de igual (=)Para chaves compostas, é recomendável usar um traço, sublinhado ou sinal de igual como um separador. Se as chaves contiverem outros símbolos, recomendamos codificar 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 cadeia de caracteres "Exemplo de chave do documento" codificada na base 64. A codificação Base64 segura por URL é recomendada porque as chaves do documento às vezes são usadas no caminho da URL. A codificação permite que você use caracteres em uma chave de documento que podem ser problemáticas 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 |
| Sugestão | 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 | Inferior | Letras, números, traços (-) |
O primeiro e o último caracteres devem ser uma letra ou número. | docdbds-onlinecatalog-20240228 |
| Indexador | 1 -128 | Inferior | Letras, números, traços (-) |
O primeiro e o último caracteres devem ser uma letra ou número. | docbindxr-onlinecatalog-20240228 |
| Mapa de sinônimos | 1 -128 | Inferior | Letras, números, traços (-) |
O primeiro e o último caracteres devem ser uma letra ou número. | custom-synonyms-2024 |
| Conjunto de habilidades | 1 -128 | Inferior | Letras, números, traços (-) |
O primeiro e o último caracteres devem ser uma letra ou número. | grok-myfiles-skillset-1 |