명명 규칙(Azure AI Search)
이 섹션에서는 Azure AI Search에 대한 명명 규칙을 설명합니다.
명명 규칙 차트
규칙은 개체 사용 방법에 따라 개체에 따라 다릅니다. 다른 표준의 명명 규칙은 특정 Azure AI Search 개체에 적용됩니다. URL 및 JSON에는 대/소문자 구분, 특수 문자 및 문자 배치 측면에서 서로 다른 규칙이 있습니다. 필요에 따라 URL(호스트 이름, 경로 또는 쿼리 문자열) 또는 JSON 요청 본문에서 참조되는 개체는 해당 표준의 명명 규칙을 따라야 합니다.
| Name | 길이 | 사례 | 허용되는 문자 | 문자 배치 | 예제 |
|---|---|---|---|---|---|
| 서비스 | 2 - 60 | 더 낮음 | 문자, 숫자, 대시(-) |
첫 번째, 두 번째 및 마지막 문자는 문자 또는 숫자여야 합니다. 아무 데도 연속 대시가 없습니다. |
contoso-srch1 |
| 인덱스 | 2 - 128 | 더 낮음 | 문자, 숫자, 대시(-), 밑줄(_) |
첫 글자는 문자 또는 숫자여야 합니다. 연속 대시 또는 밑줄 없음 |
idx-hotels-2024 |
| 필드 | 1 -128 | 대문자 또는 소문자 | 문자, 숫자, 밑줄(_) |
첫 글자는 문자여야 합니다. 이름은 "azureSearch"로 시작할 수 없습니다. |
Store_Name |
| 문서 키 | 1024 | 대문자 또는 소문자 | 문자, 숫자, 대시(-), 밑줄(_), 등호(=)복합 키의 경우에는 대시, 밑줄 또는 등호를 구분 기호로 사용하는 것이 좋습니다. 키에 다른 기호가 포함된 경우 BASE64의 URL 안전 변형을 사용하여 인코딩하는 것이 좋습니다. 예를 들어 .NET에서는 이 용도로 HttpServerUtility.UrlTokenEncode 메서드를 사용할 수 있습니다. |
첫 번째 문자는 밑줄일 수 없습니다. | RXhhbXBsZSBkb2N1bWVudCBrZXk= base 64로 인코딩된 문자열 "예제 문서 키"입니다. URL 경로에서 문서 키가 사용되는 경우가 있기 때문에 URL로부터 안전한 Base64 인코딩을 사용하는 것이 좋습니다. 이 인코딩을 사용하는 경우 일반적으로는 URL에서 문제가 되는 문자를 문서 키에 사용할 수 있습니다. |
| 점수 매기기 프로필 | 1 - 128 | 대문자 또는 소문자 | 문자, 숫자, 밑줄(_) |
첫 글자는 문자 또는 숫자여야 합니다. | BoostFunc_TagsCustHist |
| 확인기 | 1 - 128 | 대문자 또는 소문자 | 문자, 숫자, 밑줄(_) |
첫 글자는 문자 또는 숫자여야 합니다. | Sugst01_Apparel |
| 데이터 원본 | 1 - 128 | 더 낮음 | 문자, 숫자, 대시(-) |
첫 글자와 마지막 글자는 문자 또는 숫자여야 합니다. | docdbds-onlinecatalog-20240228 |
| 인덱서 | 1 -128 | 더 낮음 | 문자, 숫자, 대시(-) |
첫 글자와 마지막 글자는 문자 또는 숫자여야 합니다. | docbindxr-onlinecatalog-20240228 |
| 동의어 맵 | 1 -128 | 더 낮음 | 문자, 숫자, 대시(-) |
첫 글자와 마지막 글자는 문자 또는 숫자여야 합니다. | custom-synonyms-2024 |
| 기술 집합 | 1 -128 | 더 낮음 | 문자, 숫자, 대시(-) |
첫 글자와 마지막 글자는 문자 또는 숫자여야 합니다. | grok-myfiles-skillset-1 |