클러스터 구성 문제 해결
참고 항목
2025년 1월 31일에 Azure HDInsight on AKS가 사용 중지됩니다. 2025년 1월 31일 이전에 워크로드가 갑자기 종료되지 않도록 워크로드를 Microsoft Fabric 또는 동등한 Azure 제품으로 마이그레이션해야 합니다. 구독의 나머지 클러스터는 호스트에서 중지되고 제거됩니다.
사용 중지 날짜까지 기본 지원만 사용할 수 있습니다.
Important
이 기능은 현지 미리 보기로 제공됩니다. Microsoft Azure 미리 보기에 대한 보충 사용 약관에는 베타 또는 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 더 많은 약관이 포함되어 있습니다. 이 특정 미리 보기에 대한 자세한 내용은 Azure HDInsight on AKS 미리 보기 정보를 참조하세요. 질문이나 기능 제안이 있는 경우 AskHDInsight에서 세부 정보와 함께 요청을 제출하고 Azure HDInsight 커뮤니티에서 더 많은 업데이트를 확인하세요.
클러스터 구성이 잘못되면 배포 오류가 발생할 수 있습니다. 일반적으로 이러한 오류는 잘못된 구성이 ARM 템플릿에 제공되거나 Azure Portal(예: 구성 관리 페이지)에 입력될 때 발생합니다.
참고 항목
이러한 오류에는 “User.” 접두사로 시작하는 이유가 있습니다.
예제 구성 오류:
다음 표에서는 일반적인 오류를 진단하고 해결하는 데 도움이 되는 오류 코드와 해당 설명을 제공합니다.
구성 오류
| 오류 코드 | 설명 |
|---|---|
| User.TrinoError | 일반 오류로 인해 Trino 프로세스 시작이 실패합니다. 서비스 구성 프로필에서 Trino 관련 구성 파일을 확인합니다. |
| User.Configuration.TrinoError | 애플리케이션 구성 오류로 인해 Trino 프로세스 시작이 실패합니다. 서비스 구성 프로필에서 Trino 관련 구성 파일을 확인합니다. |
| User.Configuration.FileForbidden | 일부 Trino 구성 파일에 대한 변경은 허용되지 않습니다. |
| User.Configuration.ParameterForbidden | 일부 Trino 구성 매개 변수에 대한 변경은 허용되지 않습니다. |
| User.Configuration.InvalidComponent | 잘못된 서비스 구성 요소가 지정되었습니다. 자세한 내용은 서비스 구성 프로필을 참조하세요. |
| User.Configuration.MiscFile.InvalidName | 잘못된 기타 fileName입니다. 자세한 내용은 기타 파일을 참조하세요. |
| User.Configuration.MiscFile.InvalidPath | 기타 파일 경로가 너무 깁니다. |
| User.Configuration.MiscFile.NotFound | 기타 파일 구성에서 해당 파일이 없는 MISC 태그를 찾았습니다. 자세한 내용은 기타 파일을 참조하세요. |
| User.Configuration.MiscFile.DuplicateName | 기타 파일 구성 섹션에 있는 중복 fileName 값입니다. |
| User.Configuration.MiscFile.DuplicatePath | 기타 파일 구성 섹션에 있는 중복 경로 값입니다. |
| User.Configuration.FormatError | 잘못된 섹션에서 사용되는 잘못된 형식의 서비스 구성, 콘텐츠/값 속성입니다. 자세한 내용은 서비스 구성 프로필을 참조하세요. |
| User.Configuration.HiveMetastore.MultiplePasswords | catalogOptions.hive 카탈로그에 지정된 여러 암호입니다. metastoreDbConnectionPasswordSecret 또는 metastoreDbConnectionPassword의 두 속성 중 하나를 지정합니다. |
| User.Configuration.HiveMetastore.PasswordRequired | catalogOptions.hive 카탈로그에 필요한 암호입니다. metastoreDbConnectionPasswordSecret 또는 metastoreDbConnectionPassword의 두 속성 중 하나를 지정합니다. |
| User.Secrets.Error | Azure KeyVault에서 비밀 또는 권한이 잘못 구성되었습니다. |
| User.Secrets.InvalidKeyVaultUri | secretsProfile에 Azure Key Vault URI가 없습니다. |
| User.Secrets.KeyVaultUriRequired | secretsProfile에 Azure Key Vault URI가 없습니다. |
| User.Secrets.DuplicateReferenceName | secretsProfile에 중복된 referenceName이 있습니다. |
| User.Secrets.KeyVaultObjectUsedMultipleTimes | secretsProfile의 비밀 목록에서 다른 참조로 여러 번 사용된 동일한 키 자격 증명 모음 개체/버전입니다. |
| User.Secrets.NotSpecified | secretsProfile에서 해당 비밀 개체가 없는 SECRET_REF 태그를 찾았습니다. |
| User.Secrets.NotFound | SecretProfile에서 지정된 Key Vault 개체를 KeyVault에서 찾을 수 없습니다. 개체의 이름, 형식, 버전을 확인합니다. |
| User.Plugins.Error | 스토리지 계정에서 잘못 구성된 플러그 인 또는 권한입니다. |
| User.Plugins.DuplicateName | 클러스터 구성 userPluginsSpec에 사용되는 중복된 플러그 인 이름입니다. |
| User.Plugins.DuplicatePath | 클러스터 구성 userPluginsSpec에 사용되는 중복 플러그 인 경로입니다. |
| User.Plugins.InvalidPath | 플러그 인의 잘못된 형식의 스토리지 URI입니다. |
| User.Plugins.PathNotFound | 스토리지 계정에서 찾을 수 없는 플러그 인의 지정된 경로입니다. |
| User.Telemetry.InvalidStoragePath | userTelemetrySpec의 잘못된 형식 스토리지 URI입니다. |
| User.Telemetry.HiveCatalogNotFound | userTelemetrySpec에서 원격 분석 테이블의 대상으로 지정된 존재하지 않는 Hive 카탈로그입니다. |
| User.CatalogOptions.HiveCatalogNotFound | 지정된 catalogOptions.hive 구성의 Trino 카탈로그 서비스 구성 프로필에서 Hive 카탈로그를 찾을 수 없습니다. 자세한 내용은 Hive 메타스토어를 참조하세요. |
시스템 오류
일부 오류는 환경 조건으로 인해 발생할 수 있으며 일시적일 수 있습니다. 이러한 오류에는 “System.” 접두사로 시작하는 이유가 있습니다. 이러한 경우 다음 단계를 시도합니다.
- 다음 정보를 수집합니다.
- Azure 요청 CorrelationId. 알림 영역 또는 배포 페이지의 클러스터가 위치한 리소스 그룹 아래, 또는 az 명령 출력에서 찾을 수 있습니다.
- DeploymentId. 클러스터 개요 페이지에서 찾을 수 있습니다.
- 자세한 오류 메시지.
- 이 정보로 지원 팀에 문의하세요.
| 오류 코드 | 설명 |
|---|---|
| System.DependencyFailure | 클러스터 구성 요소 중 하나에서 오류가 발생했습니다. |