Azure Synapse Analytics 알려진 이슈
이 페이지에는 Azure Synapse Analytics의 알려진 문제와 해결 날짜 또는 가능한 해결 방법이 나열되어 있습니다. Azure 지원 요청을 제출하기 전에 이 목록을 검토하여 발생한 문제가 이미 알려져 있고 해결 중인지 확인합니다.
Azure Synapse Analytics에 대한 자세한 내용은 Azure Synapse Analytics 개요 및 Azure Synapse Analytics의 새로운 기능을 참조하세요.
알려진 활성 문제
Azure Synapse Analytics 전용 SQL 풀 활성 알려진 문제 요약
고객이 메트릭을 사용하여 전용 SQL 풀의 사용량을 모니터링할 수 없음
원격 분석 데이터의 성능과 안정성을 향상하기 위한 원격 분석 내보내기 논리의 내부 업그레이드로 인해 일부 고객이 전용 SQL 풀, tempdb 및 데이터 웨어하우스 데이터 IO 메트릭을 모니터링하는 기능에 영향을 미치는 예기치 않은 문제가 발생했습니다.
해결 방법: 문제를 확인한 후 팀에서는 근본 원인을 파악하고 시스템 구성을 업데이트하기 위한 조치를 취했습니다. 고객은 인스턴스를 일시 중지했다가 다시 시작하여 문제를 해결할 수 있습니다. 이렇게 하면 인스턴스의 정상 상태와 원격 분석 데이터 흐름이 복원됩니다.
AUTO_CREATE_TABLE='ON'인 테이블에 Parquet 파일을 수집할 때 쿼리 실패
AUTO_CREATE_TABLE='ON'을 사용하여 parquet 파일을 해시 분산 테이블에 수집하려고 하는 고객에게 다음 오류가 발생할 수 있습니다.
COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables
AUTO_CREATE_TABLE을 사용하여 자동 만들어진 해시 분산 테이블로의 수집은 지원되지 않습니다. 이전에 이 지원되지 않는 시나리오를 사용하여 로드한 고객은 데이터를 새 테이블에 CTAS를 수행하여 이전 테이블 대신 사용해야 합니다.
데이터 반출 오류로 실패한 쿼리
기존 전용 SQL 풀에서 만든 Synapse 작업 영역은 Synapse Analytics에서 데이터 반출 보호가 꺼져 있는 동안 일반 오류 메시지를 포함한 데이터 반출 보호와 관련된 쿼리 실패를 보고합니다.
Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.
해결 방법: 비슷한 오류가 발생하면 Microsoft 지원 팀에 문의하여 도움을 요청하세요.
UPDATE STATISTICS 실패
일부 전용 SQL 풀에서는 UPDATE STATISTICS 문을 실행할 때 예외가 발생할 수 있습니다. 명령을 실행하면 "제공된 통계 스트림이 손상되었습니다"라는 메시지가 표시되고 통계를 업데이트하지 못합니다.
테이블에 새 제약 조건이 추가되면 관련 통계가 배포에 생성됩니다. 클러스터형 인덱스도 테이블에 만들어지는 경우 제약 조건과 동일한 열(동일한 순서로)을 포함해야 합니다. 그렇지 않으면 해당 열에 대한 UPDATE STATISTICS 명령이 실패할 수 있습니다.
해결 방법: 테이블에 제약 조건 및 클러스터형 인덱스가 있는지 확인합니다. 그렇다면 제약 조건과 클러스터형 인덱스 모두를 DROP합니다. 그런 다음, 클러스터형 인덱스를 다시 만들고 두 항목 모두 동일한 순서로 동일한 열을 포함하도록 보장하는 제약조건을 다시 만듭니다. 테이블에 제약 조건 및 클러스터형 인덱스가 없거나 위의 단계에서 동일한 오류가 발생하는 경우 Microsoft 지원 팀에 문의하여 도움을 요청하세요.
태그 업데이트가 실패하는 것 같습니다.
Azure Portal 또는 다른 메서드를 통해 전용 SQL 풀의 태그를 변경할 때 변경이 성공하더라도 오류 메시지가 나타날 수 있습니다.
해결 방법: 태그 변경이 성공했는지 확인하고 필요에 따라 오류 메시지를 무시/표시하지 않을 수 있습니다.
Azure Synapse 작업 영역 활성 알려진 문제 요약
Synapse 작업 영역과 관련하여 알려진 문제는 다음과 같습니다.
UAMI(사용자 할당 관리 ID)를 사용하는 Blob Storage 연결된 서비스가 나열되지 않음
Azure Synapse Analytics에서 "사용자 할당 관리 ID" 인증을 사용하도록 Blob Storage 연결된 서비스를 구성한 후 연결된 서비스가 데이터 허브 ->연결 ->Azure Blob Storage에 표시되지 않을 수 있습니다.
해결 방법: 엔지니어링 팀에서 이러한 동작을 알고 있으며 해결하기 위해 노력하고 있습니다. 또는 “사용자 할당 관리 ID” 대신 “시스템 할당 관리 ID” 인증 방법을 사용합니다.
Synapse 작업 영역을 삭제하지 못했으며 가상 네트워크를 삭제할 수 없음
Synapse 작업 영역 삭제에 실패하고 다음과 같은 오류 메시지가 나타납니다.
Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;
해결 방법: 삭제 작업을 다시 시도하여 문제를 완화할 수 있습니다. 엔지니어링 팀에서 이러한 동작을 알고 있으며 해결하기 위해 노력하고 있습니다.
REST API PUT 작업 또는 ARM/Bicep 템플릿을 사용하여 네트워크 설정 업데이트 실패
ARM 템플릿, Bicep 템플릿 또는 직접 REST API PUT 작업을 사용하여 Synapse 작업 영역에 대한 공용 네트워크 액세스 설정 및/또는 방화벽 규칙을 변경하는 경우 작업이 실패할 수 있습니다.
해결 방법: REST API PATCH 작업 또는 Azure Portal UI를 사용하여 원하는 구성 변경 내용을 되돌리고 다시 시도하여 문제를 완화할 수 있습니다. 엔지니어링 팀에서 이러한 동작을 알고 있으며 해결하기 위해 노력하고 있습니다.
태그 값에 대괄호 []를 통합하는 알려진 문제
Azure Synapse 작업 영역 내에서 태그 값을 업데이트하는 컨텍스트에서 대괄호([])를 포함하면 업데이트 작업이 실패합니다.
해결 방법: 현재 해결 방법은 Azure Synapse 작업 영역 태그 값에 대괄호([])를 사용하지 않는 것입니다.
ARM 템플릿을 사용하는 GitHub 작업에서 Synapse-workspace-deployment v1.8.0을 사용하는 Synapse 작업 영역의 배포 실패
오류는 프로덕션에 배포하는 동안 발생하며 이중 백슬래시가 있는 호스트 이름이 포함된 트리거와 관련되어 있습니다.
표시된 오류 메시지는 Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057입니다.
해결 방법: 신속한 완화를 위해 다음 조치를 취할 수 있습니다.
- 이스케이프 문자 제거: 배포 전에 매개 변수 파일에서 이스케이프 문자(
\)를 수동으로 제거합니다. 즉, 배포의 구문 분석 또는 처리 단계에서 문제를 일으킬 수 있는 이러한 문자를 제거하기 위해 파일을 편집합니다. - 이스케이프 문자를 슬래시로 바꾸기: 이스케이프 문자(
\)를 슬래시(/)로 바꿉니다. 이는 많은 시스템에서 슬래시를 유효한 경로 구분 기호로 허용하는 파일 경로에서 특히 유용할 수 있습니다. 이렇게 대체하면 이스케이프 문자 문제를 우회하여 배포 프로세스가 성공하는 데 도움이 될 수 있습니다.
이러한 해결 방법 중 하나를 적용하고 성공적으로 배포한 후 작업 영역 내에서 필요한 구성을 수동으로 업데이트하여 모든 것이 올바르게 설정되었는지 확인합니다. 여기에는 구성 파일 편집, 설정 조정 또는 배포 중인 특정 환경 또는 애플리케이션과 관련된 기타 작업 수행이 포함될 수 있습니다.
"Microsoft.Synapse/workspaces/trustedServiceBypassEnabled" 설정 전용 'GET' API 작업이 없습니다.
문제 요약: Azure Synapse Analytics에는 "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled" 리소스 범위에서 "trustedServiceBypassEnabled" 설정의 상태를 검색하기 위한 전용 'GET' API 작업이 없습니다. 사용자는 이 구성을 설정할 수 있지만, 이 특정 리소스 범위를 통해 해당 상태를 직접 검색할 수는 없습니다.
영향: 이러한 제한 사항은 "trustedServiceBypassEnabled" 설정에 대해 특정 상태를 적용할 수 없으므로 Azure Policy 정의에 영향을 미칩니다. 고객은 Azure Policy를 사용하여 이 구성을 거부하거나 관리할 수 없습니다.
해결 방법: 이 속성에 대해 원하는 구성 상태를 적용하기 위해 Azure Policy에서 사용할 수 있는 해결 방법이 없습니다. 그러나 사용자는 'GET' 작업 영역 작업을 사용하여 보고 목적으로 구성 상태를 감사할 수 있습니다.
이 'GET' 작업 영역 작업은 'Microsoft.Synapse/workspaces/trustedServiceBypassEnabled' Azure Policy 별칭에 매핑됩니다.
Azure Policy 별칭은 작업이 Microsoft.Synapse/workspace 리소스에 대한 PUT 요청인 경우 거부 Azure Policy 효과와 함께 이 속성을 관리하는 데 사용할 수 있습니다. 하지만 PUT 요청이 Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration 자식 리소스로 직접 전송되는 경우에만 감사 목적으로 작동합니다. 부모 리소스에는 자식 리소스의 구성을 매핑하는 [properties.trustedServiceBypassEnabled] 속성이 있으며 이것이 부모 리소스의 Azure Policy 별칭을 통해 계속 감사될 수 있는 이유입니다.
Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration 자식 리소스에는 사용 가능한 GET 작업이 없으므로 Azure Policy는 이러한 요청을 관리할 수 없고 Azure Policy는 이에 대한 Azure Policy 별칭을 생성할 수 없습니다.
부모 리소스: Microsoft.Synapse/workspaces
자식 리소스: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration
Azure Portal은 자식 리소스에 대한 PUT API에 직접 PUT 요청을 하며, 따라서 부모 Microsoft.Synapse/workspaces API 외부에서 이루어진 다른 모든 API 요청과 함께 Azure Portal은 거부 또는 기타 실행 가능한 Azure Policy 효과를 통해 Azure Policy에서 관리할 수 없습니다.
Azure Synapse Analytics 서버리스 SQL 풀 활성 알려진 문제 요약
서버리스 SQL 풀에서 Azure Cosmos DB 분석 저장소로의 쿼리 실패
서버리스 SQL 풀에서 Azure Cosmos DB 분석 저장소로의 쿼리는 다음 오류 메시지 중 하나로 인해 실패할 수 있습니다.
Resolving CosmosDB path has failed with error 'This request is not authorized to perform this operation'Resolving CosmosDB path has failed with error 'Key not found'
이 문제를 확인하려면 다음 조건이 참이어야 합니다.
- Azure Cosmos DB 분석 저장소에 대한 연결은 프라이빗 엔드포인트를 사용합니다.
- 쿼리를 다시 시도하면 성공합니다.
해결 방법: 엔지니어링 팀은 이 동작을 알고 있으며 다음 작업을 신속하게 완화할 수 있습니다.
- 실패한 쿼리를 다시 시도합니다. 그러면 만료된 토큰이 자동으로 새로 고쳐집니다.
- 프라이빗 엔드포인트를 사용하지 않도록 설정합니다. 이 변경 내용을 적용하기 전에 변경 내용이 회사 보안 정책을 준수하는지 보안 팀과 확인하십시오.
Azure Cosmos DB 분석 저장소 보기가 열에 잘못된 특성 전파
Cosmos DB 분석 저장소를 통해 Azure Synapse 서버리스 풀의 뷰를 사용하는 동안에 Cosmos DB 분석 저장소의 파일에 변경 내용이 생기면 이 변경 내용은 고객이 뷰에서 사용하는 SELECT 문에 올바르게 전파되지 않습니다. 결과적으로 특성이 결과의 다른 열에 잘못 매핑됩니다.
해결 방법: 엔지니어링 팀은 이 동작을 알고 있으며 다음 작업을 신속하게 완화할 수 있습니다.
- 열 이름을 변경하여 보기를 다시 만듭니다.
- 가능하면 뷰를 사용하지 마세요.
자격 증명이 사용된 경우 데이터베이스 범위 자격 증명 변경이 실패합니다.
때로는 ALTER DATABASE SCOPED CREDENTIAL 쿼리를 실행하지 못할 수도 있습니다. 이 문제의 근본 원인은 자격 증명이 처음 사용된 후 캐시되어 변경이 불가능하기 때문입니다. 반환된 오류는 다음과 같습니다.
Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.
해결 방법: 엔지니어링 팀에서 이러한 동작을 알고 있으며 해결하기 위해 노력하고 있습니다. 해결 방법으로 자격 증명을 삭제하고 만들 수 있습니다. 이는 자격 증명을 사용하여 외부 테이블을 다시 만드는 것을 의미합니다. 또는 Microsoft 지원 팀에 도움을 요청할 수 있습니다.
서버리스 SQL 풀의 쿼리 실패
사용자에게 스토리지에 대한 필수 권한이 있음에도 불구하고 토큰 만료로 인해 쿼리 실행 중에 오류가 발생할 수 있습니다. 이러한 오류 메시지는 RBAC(역할 기반 액세스 제어) 역할이 스토리지 계정에 할당되지 않은 경우와 같은 일반적인 사용자 오류로 인해 발생할 수도 있습니다.
오류 메시지 예시:
WaitIOCompletion call failed. HRESULT = 0x80070005'. File/External table name: {path}Unable to resolve path '%' Error number 13807, Level 16, State 1, Message "Content of directory on path '%' cannot be listed.Error 16561: External table '<table_name>' is not accessible because content of directory cannot be listed.Error 13822: File {path} cannot be opened because it does not exist or it is used by another process.Error 16536: Cannot bulk load because the file "%ls" could not be opened.
해결 방법:
해결 방법은 Microsoft Entra(이전의 Azure Active Directory) 또는 MSI(관리 서비스 ID) 인증에 따라 다릅니다.
Microsoft Entra 토큰 만료의 경우:
장기 실행 쿼리의 경우 사용자 ID를 사용하는 대신 서비스 주체, 관리 ID 또는 SAS(공유 액세스 서명)로 전환합니다. 자세한 내용은 Azure Synapse Analytics에서 서버리스 SQL 풀에 대한 스토리지 계정 액세스 제어를 참조하세요.
클라이언트(SSMS/ADS)를 다시 시작하여 새 토큰을 획득하여 연결을 설정합니다.
MSI 토큰 만료의 경우:
- 토큰 캐시를 지우려면 풀을 비활성화한 다음, 활성화합니다. Microsoft 지원 팀에 도움을 요청하세요.
인증 헤더가 너무 길어서 스토리지 액세스 문제가 발생함
서버리스 SQL 풀의 오류 메시지 예:
File {path} cannot be opened because it does not exist or it is used by another process.Content of directory on path {path} cannot be listed.WaitIOCompletion call failed. HRESULT = {code}'. File/External table name: {path}
이러한 제네릭 스토리지 액세스 오류는 쿼리를 실행할 때 나타납니다. 한 작업 영역에서는 사용자에게 문제가 발생할 수 있지만 다른 작업 영역에서는 제대로 작동합니다. 이 동작은 토큰 크기로 인해 예상됩니다.
PowerShell에서 다음 명령을 실행하여 Microsoft Entra 토큰 길이를 확인합니다. 비퍼블릭 클라우드의 경우 -ResourceUrl 매개 변수 값이 다릅니다. 토큰 길이가 11000에 가까우거나 그 이상이면 완화 섹션을 참조하세요.
(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length
해결 방법:
제안된 해결 방법은 다음과 같습니다.
- 스토리지 액세스 제어에 설명된 대로 관리 ID 스토리지 권한 부여로 전환합니다.
- 보안 그룹 수를 줄입니다(90개 이하의 보안 그룹을 사용하면 호환되는 길이의 토큰을 얻을 수 있음).
- 보안 그룹 수를 200개 이상으로 늘립니다(토큰 구문 방법이 변경되므로 전체 그룹 목록 대신 MS Graph API URI가 포함됨). 새로 만들어진 그룹에 사용자를 추가해야 하는 경우 관리 그룹에 따라 더미/인공 그룹을 추가하면 됩니다.
보기를 쿼리하면 예기치 않은 결과가 표시됩니다.
보기를 만든 후 기본 스키마가 변경된 보기를 쿼리하면 예기치 않은 결과가 발생할 수 있습니다. 즉, 보기가 수정되었거나 더 이상 존재하지 않는 열 또는 개체를 참조합니다. 이 문제를 해결하려면 기본 스키마 변경 내용에 맞게 보기 정의를 수동으로 조정해야 합니다.
해결 방법: 보기 정의를 수동으로 조정합니다.
최근에 닫은 알려진 문제
| Synapse 구성 요소 | 문제 | 상태 | 해결된 날짜 |
|---|---|---|---|
| Azure Synapse 서버리스 SQL 풀 | Microsoft Entra 인증을 사용하는 쿼리가 1시간 후에 실패함 | 해결됨 | 2023년 8월 |
| Azure Synapse 서버리스 SQL 풀 | OPENROWSET을 사용하여 Cosmos DB 데이터를 읽는 동안 오류 쿼리 | 해결됨 | 2023년 3월 |
| Azure Synapse: Apache Spark 풀 | 파이프라인에서 Notebooks를 사용할 때 Apache Spark용 Azure Synapse 전용 SQL 풀 커넥터를 사용하여 Synapse Spark에서 SQL 전용 풀에 쓰지 못했습니다. | 해결됨 | 2023년 6월 |
| Azure Synapse: Apache Spark 풀 | 스토리지 계정 제한으로 인해 특정 Spark 작업(job 또는 task)이 너무 일찍 실패하고 오류 코드 503이 발생함 | 해결됨 | 2023년 11월 |
| Azure Synapse: Apache Spark 풀 | Spark 3.4 런타임에서 Synapse 전용 SQL 풀 커넥터를 사용하는 LIKE 절을 사용한 쿼리 실패 | 해결됨 | 2024년 10월 |
Azure Synapse Analytics 서버리스 SQL 풀이 최근에 닫힌 알려진 문제 요약
Microsoft Entra 인증을 사용하는 쿼리가 1시간 후에 실패함
1시간 이상 활성 상태로 유지되는 Microsoft Entra 인증을 사용하는 SQL 연결이 실패하기 시작합니다. 여기에는 Microsoft Entra 통과 인증 및 Microsoft Entra와 상호 작용하는 명령문(예: CREATE EXTERNAL PROVIDER)을 사용하여 스토리지를 쿼리하는 작업이 포함됩니다. 이는 SSMS 및 ADS의 쿼리 편집기와 같이 연결을 활성 상태로 유지하는 모든 도구에 영향을 줍니다. 쿼리를 실행하기 위해 새 연결을 여는 도구(예: Synapse Studio)는 영향을 받지 않습니다.
상태: 해결됨
OPENROWSET을 사용하여 Azure Cosmos DB 데이터를 읽는 동안 오류 쿼리
OPENROWSET을 사용한 서버리스 SQL 풀에서 Cosmos DB 분석 저장소로의 쿼리는 다음 오류 메시지와 함께 실패할 수 있습니다.
Resolving CosmosDB path has failed with error 'bad allocation'.
상태: 해결됨
Azure Synapse Analytics Apache Spark 풀이 최근에 종료된 알려진 문제 요약
파이프라인에서 Notebooks를 사용할 때 Apache Spark용 Azure Synapse 전용 SQL 풀 커넥터를 사용하여 Synapse Spark에서 SQL 전용 풀에 쓰지 못했습니다.
Apache Spark용 Azure Synapse 전용 SQL 풀 커넥터를 사용하여 파이프라인에서 Notebooks를 사용하여 Azure Synapse 전용 풀을 작성하는 동안 다음 오류 메시지가 표시됩니다.
com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: COPY statement input file schema discovery failed: Cannot bulk load. The file does not exist or you don't have file access rights.
상태: 해결됨
스토리지 계정 제한으로 인해 특정 Spark 작업(job 또는 task)이 너무 일찍 실패하고 오류 코드 503이 발생함
2023년 10월 3일부터 2023년 11월 16일 사이에 스토리지 API 제한 임계값을 초과하여 Spark 작업/태스크 오류가 발생할 수 있는 Azure Synapse Analytics Apache Spark 풀은 거의 없습니다.
상태: 해결됨
Spark 3.4 런타임에서 Synapse 전용 SQL 풀 커넥터를 사용하는 LIKE 절을 사용한 쿼리 실패
오픈 소스 Apache Spark 3.4에는 특수 문자를 이스케이프하는 문제가 발생했지만 Synapse SQL은 escape 키워드를 지원하지 않습니다. 고객이 Apache Spark용 Azure Synapse 전용 SQL 풀 커넥터를 사용하는 경우 Synapse SQL에 대해 잘못된 SQL 쿼리를 생성할 수 있으며 Synapse Spark Notebook 또는 일괄 작업에서 다음과 유사한 오류가 발생합니다.
com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: com.microsoft.sqlserver.jdbc.SQLServerException: Parse error at line: 1, column: XXX: Incorrect syntax near ''%test%''
상태: 해결됨