이 섹션에서는 Azure AI Search의 명명 규칙에 대해 설명합니다.
명명 규칙 차트
규칙은 객체가 사용되는 방식에 따라 객체마다 다릅니다. 다른 표준의 명명 규칙은 특정 Azure AI Search 개체에 적용됩니다. URL과 JSON은 대소문자 구분, 특수 문자 및 문자 배치 측면에서 서로 다른 규칙을 가지고 있습니다. 필요에 따라 URL(호스트 이름, 경로 또는 쿼리 문자열) 또는 JSON 요청 본문에서 참조되는 개체는 해당 표준의 명명 규칙을 따라야 합니다.
| 이름 | Length | 사례 | 허용되는 문자 | 캐릭터 배치 | Example |
|---|---|---|---|---|---|
| 서비스 | 2 - 60 | 낮음 | 문자, 숫자, 대시(-) |
첫 번째, 두 번째 및 마지막 문자는 문자 또는 숫자여야 합니다. 어디에도 연속 대시가 없습니다. |
contoso-srch1 |
| Index | 2 - 128 | 낮음 | 문자, 숫자, 대시(-), 밑줄(_) |
첫 번째 문자는 문자 또는 숫자여야 합니다. 연속 대시나 밑줄 없음 |
IDX-호텔-2024 |
| 분야 | 1 -128 | 상부 또는 하부 | 문자, 숫자, 밑줄(_) |
첫 번째 문자는 문자여야 합니다. 이름은 "azureSearch"로 시작할 수 없습니다. |
Store_Name |
| 문서 키 | 1024 | 상부 또는 하부 | 문자, 숫자, 대시(-), 밑줄(_), 등호(=)복합 키의 경우 대시, 밑줄 또는 등호를 구분 기호로 사용하는 것이 좋습니다. 키에 다른 기호가 포함된 경우 URL로부터 안전한 Base64 변형을 사용하여 인코딩하는 것이 좋습니다. 예를 들어 NET에서는 이 용도로 HttpServerUtility.UrlTokenEncode 메서드를 사용할 수 있습니다. |
첫 번째 문자는 밑줄이 될 수 없습니다. | RXhhbXBsZSBkb2N1bWVudCBrZXk= 64진법으로 인코딩된 문자열 "예제 문서 키"입니다. URL 경로에 문서 키가 사용되는 경우가 있으므로 URL로부터 안전한 Base64 인코딩을 사용하는 것이 좋습니다. 인코딩을 사용하면 URL에서 문제가 될 수 있는 문자를 문서 키에 사용할 수 있습니다. |
| 채점 프로필 | 1 - 128 | 상부 또는 하부 | 문자, 숫자, 밑줄(_) |
첫 번째 문자는 문자 또는 숫자여야 합니다. | BoostFunc_TagsCustHist |
| 제안자 | 1 - 128 | 상부 또는 하부 | 문자, 숫자, 밑줄(_) |
첫 번째 문자는 문자 또는 숫자여야 합니다. | Sugst01_Apparel |
| 데이터 원본 | 1 - 128 | 낮음 | 문자, 숫자, 대시(-) |
첫 번째와 마지막 문자는 문자 또는 숫자여야 합니다. | docdbds-online카탈로그-20240228 |
| 인덱서 | 1 -128 | 낮음 | 문자, 숫자, 대시(-) |
첫 번째와 마지막 문자는 문자 또는 숫자여야 합니다. | docbindxr-online카탈로그-20240228 |
| 동의어 맵 | 1 -128 | 낮음 | 문자, 숫자, 대시(-) |
첫 번째와 마지막 문자는 문자 또는 숫자여야 합니다. | 사용자 정의 동의어-2024 |
| 기술 집합 | 1 -128 | 낮음 | 문자, 숫자, 대시(-) |
첫 번째와 마지막 문자는 문자 또는 숫자여야 합니다. | 그로그-마이파일-스킬셋-1 |