가상 테이블의 알려진 제한 사항 및 문제 해결

이 문서에서는 Microsoft Dataverse에서 가상 테이블로 작업할 때 알려진 제한 사항 및 문제 해결 팁에 대해 설명합니다.

알려진 제한 사항

다음은 가상 커넥터 공급자를 사용하여 만든 가상 테이블에 대한 알려진 제한 사항 목록입니다.

일반 질문

• 사용되는 테이블 또는 목록에는 기본 필드로 사용할 하나 이상의 문자열 필드와 하나의 GUID 필드가 포함되어야 합니다. 이러한 문자열 필드가 없으면 가상 테이블을 생성할 수 없으며 테이블 세부 정보 검색 단계에서 오류가 생성됩니다.
  • SharePoint는 모든 목록에 있는 숨겨진 숫자 ID 필드를 사용합니다.
  • SQL은 GUID 또는 정수 필드를 사용할 수 있습니다.
  • Excel에는 GUID 필드가 있어야 합니다.
• Dataverse는 Dataverse와 호환되는 데이터 유형을 포함하는 열만 생성할 수 있습니다. 여기에는 다음과 같은 데이터 유형이 있습니다.
  • String
  • 여러 줄 텍스트(메모)
  • 정수/Integer
  • 10진
  • 플로트
  • 날짜/시간
  • 예/아니오(부울)
  • 선택(다중 값 선택)
  • 하이퍼링크/URL
• 가상 테이블에 대해 지원되지 않는 데이터 유형:
  • 파일 및 첨부 파일
  • Image
  • Lookup
• 가상 테이블의 텍스트 열에 허용되는 최대 문자 길이는 4000자입니다. 원본 테이블에 이 값보다 큰 최대 문자 제한이 있는 경우 최대 문자 제한을 초과하는 생성/업데이트 작업은 유효성 검사 오류를 발생시키고 작업은 실패합니다.
• 가상 테이블 쿼리는 1,000개의 레코드를 반환하도록 제한됩니다. 가상 테이블과 1:N 또는 N 사용자 지정 다중 테이블(다형성) 관계가 있는 경우 이 제한을 초과하는 모든 쿼리는 실패하고 오류를 제공합니다. 쿼리에서 필터링을 사용하여 이 제한 사항에 대한 해결 방법으로 레코드 집합을 줄이십시오.
• 가상 테이블에는 감사 기능을 사용할 수 없으며 이는 Dataverse이 로컬에 저장된 데이터에 대한 감사 데이터만 수행하고 저장할 수 있기 때문입니다.
• 롤업 및 계산된 필드는 가상 테이블에 대해 계산할 수 없습니다. 롤업은 데이터를 로컬에 저장해야 하는 Dataverse의 서버 측 계산이기 때문입니다.
• Microsoft에서 제공하는 Microsoft Entra ID 가상 테이블은 읽기 액세스만 허용합니다.
• Dataverse 가상 테이블은 Dataverse의 일반 최대값을 초과하는 필드의 값을 표시할 수 있습니다. 이 동작은 표시되는 값이 로컬에 저장되지 않기 때문입니다. 예를 들어 Dataverse 정수 최대값은 100,000,000,000이지만 SharePoint에서 9,000,000,000,000을 검색하여 표시할 수 있습니다. 그러나 사용자가 Dataverse에서 허용되는 최대 크기보다 큰 크기로 숫자를 편집하려고 하면 최대 크기를 초과하여 레코드를 저장할 수 없음을 나타내는 오류가 제공됩니다.
• 가상 테이블에서는 테이블 데이터 가져오기 및 내보내기 기능이 지원되지 않습니다.

각 데이터 소스에 대해

다음은 각 데이터 원본에 대한 제한 사항입니다.

SQL Server

• SQL 가상 테이블은 기능의 기본 키로 GUID 또는 정수 필드를 사용할 수 있습니다.
• 기본 키가 없는 SQL Server 테이블: 문자열이 아닌 모든 필드를 기본 키로 선택할 수 있습니다. 가상 테이블이 성공적으로 생성되어야 합니다. RetrieveMultiple이 작동하고 다른 작업이 "APIM 요청이 성공하지 못했습니다. BadRequest: 테이블에 기본 키가 없습니다." 오류 메시지(SQL 커넥터에서 발생)와 함께 실패합니다. 기능을 위해서는 GUID 또는 정수 필드를 기본 키로 사용해야 합니다.
• 문자열 기본 키를 사용하는 SQL Server 테이블: SQL 문자열 기본 키는 가상 테이블 기본 키에 사용할 수 있는 유일한 옵션입니다. SQL Server 문자열 기본 키는 값을 GUID로 구문 분석할 수 있는 경우에만 지원됩니다. GUID로 구문 분석할 수 없는 경우 가상 테이블 만들기는 성공하지만 런타임에 실패하고 다음 오류가 발생합니다.
  • Maker Portal: "테이블을 열 수 없습니다. 새로고침하거나 다시 열어보세요."
  • 네트워크 추적: "문자열 기본 키는 GUID로 구문 분석할 수 있는 경우에만 지원됩니다."
• 기본 이름으로 사용할 기본 키가 아닌 문자열 필드가 없는 SQL Server 테이블: SQL 테이블에 기본 이름으로 사용할 수 있는 문자열 필드가 없으면 구성 단계에서 다음 오류가 표시됩니다. "테이블에 기본 필드가 없습니다"
• SQL 보기는 가상 테이블을 만드는 데 사용할 수 있지만 읽기 작업만 제공합니다.
• SQL Server 커넥터 제한 사항은 SQL Server 커넥터 참조로 이동하세요.
• 원본 테이블의 SQL 데이터 형식 bigint 열은 Dataverse 가상 테이블에서 10진수 데이터 형식으로 매핑됩니다. 정수에 대한 bigint 매핑에 대해 플랫폼 지원을 사용할 수 있는 경우 가상 테이블에서 이전에 생성된 열을 삭제하고 새 열을 생성해야 합니다.
• 현재 다음 열 유형은 가상 테이블에 포함될 수 없습니다.
  • 시간
  • Datetime2
  • Image
  • 기하학
  • 지역
  • RowVersion
• 다음 열 유형은 가상 테이블에 포함되지만 텍스트 필드로만 표시됩니다.
  • HierarchyID
  • XML
  • Sqlvariant

Microsoft Excel Online (Business)

• Excel은 현재 테이블 기반 가상 테이블 환경에서 지원되지 않습니다.
• 가상 테이블 연결에 참여하려면 Excel 파일을 OneDrive에 저장해야 합니다.
• 기본 원본 테이블을 설계하는 동안 열이 자동으로 증가하도록 설정하지 않은 경우 기본 키 열이 생성 양식에 포함되어야 합니다. 삽입 작업이 성공하려면 기본 키 열에 유효한 값을 입력해야 합니다.
• 엔터티 카탈로그 생성 시간이 오래 걸리는 경우 설정 -> 고급 설정 -> 설정 -> 시스템 작업 보기로 이동하여 작업 완료 상태를 확인할 수 있습니다.
• GUID 값을 포함하는 열만 기본 키가 될 수 있습니다. Excel 테이블 메타데이터는 모든 열을 문자열로 표시하기 때문에 현재 설계에서는 기본 키가 항상 문자열로 표현되는 GUID라고 가정합니다.

  참고

  가상 엔터티가 생성될 때 유효성 검사가 수행되지 않습니다. GUID가 아닌 열을 선택하면 런타임에 엔터티가 실패하고 다음 오류가 표시됩니다. "문자열 기본 키는 GUID로 구문 분석할 수 있는 경우에만 지원됩니다."

• PowerAppsId__ 자동 생성 열 지원: PowerAppsId 자동 생성 열이 발견되면 사용됩니다(기본 키에 사용할 수 있는 유일한 옵션임). 자동으로 생성된 값이 실제로 값을 덮어쓰더라도 레코드 생성 시 PowerAppsId에 대한 값을 제공해야 합니다. 기본 키 열이 PowerAppsId 자동 생성 열이 아닌 경우에는 이런 일이 발생하지 않습니다.
• 현재 다음 열 유형은 가상 테이블에 포함될 수 없습니다.
  • 시간(날짜/시간 필드로 생성됩니다).
• 특정 Excel 커넥터 제한 사항: Excel Online(Business) 커넥터 참조.

Microsoft SharePoint

• 현재 가상 테이블의 SharePoint 열에 대해 모두 보기를 선택할 수 없습니다. 이 문제는 알려진 문제입니다.
• 현재 다음 열 유형은 가상 테이블에 포함될 수 없습니다.
  • 사람
  • Image
  • 관리되는 메타데이터
  • 위치: 좌표
  • 첨부
• 가상 테이블에 표시될 SharePoint 특정 열:
  • 규정 준수 자산 ID는 추적 목적을 위한 SharePoint의 내부 열입니다. 무시할 수 있습니다.
  • ID는 SharePoint의 외부 기본 키입니다. 읽기 전용이며 무시할 수 있습니다.

Salesforce(프리뷰)

• Salesforce 커넥터 제한 사항을 확인하려면 Salesforce 커넥터 참조로 이동하세요.
• 다른 Salesforce 개체를 참조하는 필드는 잠겨 있습니다.

문제 해결

• 원본 테이블에 더 많은 레코드가 있음에도 불구하고 가상 테이블에 하나의(1) 레코드만 표시됩니다.
  솔루션: 소스 테이블을 확인하고 기본 키가 정의되어 있는지 확인하십시오.

• Power Apps(make.powerapps.com)가 내 테이블 목록을 검색하거나 마침을 선택하여 내 테이블을 만들 때 다음 오류 중 하나가 발생합니다.

  • "세그먼트 msdyn_get_required_fields에 리소스가 없습니다"
  • "호출 오류... 환경에 연결이 있는지 확인하십시오..."
  • "시퀀스가 msdyn_get_required_fields에 대한 요소와 일치하지 않습니다"
    솔루션: 경우에 따라 가상 커넥터 공급자에 대한 최신 솔루션이 없을 수 있습니다. 가상 커넥터 공급자 솔루션에 업데이트가 필요한지 여부를 확인하려면:
  1. 왼쪽 탐색 창에서 솔루션을 선택합니다. 항목이 측면 패널 창을 경우 ...자세히를 선택한 다음 원하는 항목을 선택하세요.
  2. 기록 탭을 선택합니다.
  3. ConnectorProvider를 검색합니다.
  4. 정보를 보고 솔루션을 업데이트해야 하는지 여부를 확인합니다.
  5. 기록에 업데이트가 필요하다고 표시되면 Virtual Connector Provider에 대한 Microsoft 상업용 마켓플레이스 검색으로 이동한 다음 지금 가져오기를 선택하여 솔루션을 환경으로 가져옵니다.
  6. 단계에 따라 가상 테이블을 다시 생성합니다.

• "현재 환경에서 연결 'xyz'를 찾을 수 없습니다."라는 메시지가 표시됩니다. 연결 목록을 검색할 때.
  해결 방법: 이는 사용자의 Dataverse 환경에 연결 수가 많은 경우 발생합니다. 이것은 커넥터 공급자 솔루션 버전 1029에서 수정되었습니다. 업데이트된 버전은 2023년 2월 20일까지 모든 지역에 제공될 것입니다. 가상 커넥터 공급자 솔루션에 업데이트가 필요한지 여부를 확인하려면:

  1. 왼쪽 탐색 창에서 솔루션을 선택합니다. 항목이 측면 패널 창을 경우 ...자세히를 선택한 다음 원하는 항목을 선택하세요.
  2. 기록 탭을 선택합니다.
  3. ConnectorProvider를 검색합니다.
  4. 정보를 보고 솔루션을 업데이트해야 하는지 여부를 확인합니다.
  5. 기록에 업데이트가 필요하다고 표시되면 Virtual Connector Provider에 대한 Microsoft 상업용 마켓플레이스 검색으로 이동한 다음 지금 가져오기를 선택하여 솔루션을 환경으로 가져옵니다.
  6. 단계에 따라 가상 테이블을 다시 생성합니다.

• 가상 테이블 생성 중에 시간 초과가 발생했다는 알림을 받았습니다.
  솔루션: 이는 다른 기존 작업으로 인해 가상 테이블 생성이 지연될 때 발생할 수 있습니다. 몇 분 정도 기다린 후 다시 시도하세요.

• "예기치 않은 오류가 발생했습니다"라는 알림이 표시됩니다.
  해결 방법: 이 문제는 가상 테이블 데이터 원본이 잘못된 값으로 생성되었을 때 발생합니다. 이 문제를 해결하려면 오류를 일으키는 가상 테이블 데이터 원본을 찾아서 삭제한 다음 가상 테이블을 다시 만들어야 합니다.

  1. 설정(기어 아이콘) > Power Apps의 고급 설정을 선택합니다.
  2. 상단 메뉴에서 설정을 선택합니다.
  3. 솔루션으로 이동합니다. 항목이 측면 패널 창을 경우 ...자세히를 선택한 다음 원하는 항목을 선택하세요.
  4. 가상 테이블이 포함된 솔루션으로 이동합니다(솔루션을 사용하지 않은 경우 Common Data Services 기본 솔루션으로 이동).
  5. 왼쪽 패널에서 가상 테이블 데이터 원본을 선택합니다.
  6. 각 데이터 소스(모두 VCP_DS_...로 시작)를 두 번 클릭하고 오류가 있는 데이터 소스를 찾으면 해당 데이터 원본을 삭제합니다.
  7. 가상 테이블을 다시 만듭니다.

• 다음 메시지가 표시됩니다. "이 테이블은 이미 존재합니다. 테이블을 다시 만들고 있습니다. 기본 필드와 스키마 이름은 변경할 수 없습니다."
  솔루션: 이 테이블은 이전에 생성되었습니다. 생성을 계속하면 테이블이 다시 생성되며, 이로 인해 데이터 원본에서 수행된 모든 테이블 변경 사항이 가상 테이블에서 업데이트됩니다(여기에는 필드 추가 또는 제거 포함). 사용자 지정 이름과 기본 필드 값은 편집할 수 없습니다.

• 오류 메시지: "primary_key_name은 비워둘 수 없습니다"
  솔루션: 기본 키에 대한 GUID 값을 포함하지 않는 테이블 또는 목록을 선택했습니다. 가상 테이블을 만들려면 원본 테이블에 추가 GUID 열을 추가해야 합니다.

• Excel 가상 테이블을 생성했는데 "테이블"에서 볼 수 없습니다.
  솔루션: 가상 테이블 생성은 비동기식이므로 시스템 작업에서 프로세스 상태를 확인할 수 있습니다. 이름이 Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin으로 시작하고 관련 열 값이 새 가상 테이블의 이름과 같은 시스템 작업을 찾습니다. 상태가 여전히 진행 중이면 작업이 완료될 때까지 기다리십시오. 오류가 있는 경우 시스템, 작업 이름 하이퍼링크를 클릭하여 세부 정보를 얻을 수 있습니다. 이 예에서는 테이블 생성이 아직 보류 중입니다.

  

  여기에서 429 "Too Many Requests" 오류로 인해 테이블 생성에 실패했습니다.

  

• 테이블 생성의 시스템 작업이 성공했지만 유효하지 않거나 누락된 열과 관련된 런타임 오류가 발생합니다
  솔루션: 테이블의 필드 생성 중 실패가 발생하더라도 테이블 생성 프로세스는 실패하지 않고 나머지 필드를 계속 시도합니다. 일부 열 유형이 지원되지 않을 때 가상 테이블 생성을 차단하고 싶지 않기 때문입니다. 오류에 대한 세부 정보를 얻으려면 관리> 환경 설정 > 사용자 지정 > 플러그인 추적 로그에 대한 로깅 활성화에서 로그인을 활성화한 다음 가상 테이블을 삭제하고 다시 생성해 보십시오.

다음 단계

가상 커넥터 공급자를 사용하여 가상 테이블 만들기(프리뷰)

가상 테이블 관계 설정