다음을 통해 공유


명명 규칙(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

추가 정보