다음을 통해 공유

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

  • 아티클

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

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

일반적인 제한 사항

  • 사용되는 테이블 또는 목록에는 기본 필드로 사용할 하나 이상의 문자열 필드와 하나의 GUID 필드가 포함되어야 합니다. 이러한 문자열 필드가 없으면 가상 테이블를 생성할 수 없으며 테이블 세부 정보 검색 단계에서 오류가 생성됩니다.
    • SharePoint는 모든 목록에 있는 숨겨진 숫자 ID 필드를 사용합니다.
    • SQL은 GUID 또는 정수 필드를 사용할 수 있습니다.
    • Excel에는 GUID 필드가 있어야 합니다.
  • Dataverse는 Dataverse와 호환되는 데이터 유형을 포함하는 열만 생성할 수 있습니다. 여기에는 다음과 같은 데이터 유형이 포함됩니다.
    • String
    • 여러 줄 텍스트(메모)
    • 정수/Integer
    • 10진
    • 플로트
    • 날짜/시간
    • 예/아니오(부울)
    • 선택(다중 값 선택)
    • 하이퍼링크/URL
  • 가상 테이블에 지원되지 않는 데이터 유형:
    • 파일 및 첨부 파일
    • Image
  • 가상 테이블의 텍스트 열에 허용되는 최대 문자 길이는 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 가상 테이블은 기능의 기본 키로 GUID 또는 정수 필드를 사용할 수 있습니다.
  • 기본 키가 없는 SQL Server 테이블: 문자열이 아닌 모든 필드를 기본 키로 선택할 수 있습니다. 가상 테이블이 성공적으로 생성되어야 합니다. RetrieveMultiple 작동합니다. 다른 작업은 다음 오류 메시지(SQL 커넥터에서 발생)와 함께 실패합니다. "APIM 요청이 성공하지 못했습니다. BadRequest: 테이블에 기본 키가 없습니다." 기능을 위해서는 GUID 또는 정수 필드를 기본 키로 사용해야 합니다.
  • 문자열 기본 키를 사용하는 SQL Server 테이블: SQL 문자열 기본 키는 가상 테이블 기본 키에 사용할 수 있는 유일한 옵션입니다. SQL Server 문자열 기본 키는 값을 GUID로 구문 분석할 수 있는 경우에만 지원됩니다. GUID로 구문 분석할 수 없는 경우 가상 테이블 만들기는 성공하지만 런타임에 실패하고 다음 오류가 발생합니다.
    • Power Apps (make.powerapps.com): "테이블을 열 수 없습니다. 새로고침하거나 다시 열어보세요."
    • 네트워크 추적: "문자열 기본 키는 GUID로 구문 분석할 수 있는 경우에만 지원됩니다."
  • SQL 기본 이름으로 사용할 비기본 키 문자열 필드가 없는 서버 테이블: SQL 테이블에 기본 이름으로 사용할 수 있는 문자열 필드가 없으면 구성 단계에서 다음 오류가 표시됩니다. "테이블에 기본 필드가 없습니다."
  • SQL 보기는 가상 테이블을 만드는 데 사용할 수 있지만 읽기 작업만 제공합니다.
  • SQL 서버 커넥터 제한 사항에 대한 자세한 내용은 SQL 서버 커넥터 참조를 참조하세요.
  • SQL 데이터 유형 bigint 열은 소스 테이블의 10진수 데이터 유형으로 매핑됩니다. Dataverse 정수에 대한 bigint 매핑에 대해 플랫폼 지원을 사용할 수 있는 경우 가상 테이블에서 이전에 생성된 열을 삭제하고 새 열을 생성해야 합니다.
  • 다음 열 유형은 현재 가상 테이블에 포함될 수 없습니다.
    • 시간
    • Datetime2
    • Image
    • 기하학
    • 지역
    • RowVersion
  • 다음 열 유형은 가상 테이블에 포함되지만 텍스트 필드로만 표시됩니다.
    • HierarchyID
    • XML
    • Sqlvariant

문제 해결

  • 원본 테이블에 더 많은 레코드가 있음에도 불구하고 가상 테이블에 하나의(1) 레코드만 표시됩니다.
    해결 방법: 소스 테이블을 확인하여 기본 키가 정의되어 있는지 확인하세요.

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

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

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

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

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

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

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

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

  • 오류 메시지: "primary_key_name은 비워둘 수 없습니다"
    해결책: 기본 키에 대한 GUID 값이 포함되지 않은 테이블이나 목록을 선택했습니다. 가상 테이블를 만들려면 소스 테이블에 추가 GUID 열을 추가해야 합니다.

  • Excel 가상 테이블를 만들었지만 표 영역에 표시되지 않습니다. Power Apps
    해결책: 가상 테이블 생성은 비동기적으로 이루어지므로 시스템 작업에서 프로세스 상태를 확인할 수 있습니다. 이름이 Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin 로 시작하고 Regarding 열 값이 새 가상 테이블의 이름과 같은 시스템 작업을 찾습니다. 상태가 여전히 진행 중인 경우 작업이 완료될 때까지 기다리세요. 오류가 있는 경우 시스템, 작업 이름 하이퍼링크를 선택하면 세부 정보를 얻을 수 있습니다. 이 예에서는 테이블 생성이 아직 보류 중입니다.

    테이블 생성 보류 중

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

    429 오류로 인해 테이블 생성에 실패했습니다.

  • 테이블 생성의 시스템 작업은 성공했지만 잘못되었거나 누락된 열과 관련된 런타임 오류가 발생했습니다.
    해결책: 테이블 필드를 생성하는 동안 오류가 발생하는 경우, 테이블 생성 프로세스는 실패하지 않고 나머지 필드로 계속 진행하려고 시도합니다. 이는 일부 열 유형이 지원되지 않는 경우 시스템이 가상 테이블 생성을 차단하지 않으려 하기 때문입니다. 오류에 대한 자세한 내용을 알아보려면 관리>시스템 설정>사용자 정의>플러그인 추적 로그에 대한 로깅을 활성화한 다음 가상 테이블를 삭제하고 다시 만들어 보세요.

다음 단계

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

가상 테이블 관계 설정