다음을 통해 공유


모델 개체(TMSL)

적용 대상: SQL Server 2016 이상 Analysis Services Azure Analysis Services Fabric/Power BI Premium

테이블 형식 모델을 정의합니다. 데이터베이스당 하나의 모델과 지정된 명령에서 지정할 수 있는 데이터베이스가 하나만 있습니다. Database 개체는 부모 개체입니다.

모델 정의가 너무 커서 한 항목에서 전체 구문을 재현할 수 없습니다. 이러한 이유로 자식 개체에 대한 링크와 함께 기본 부분을 강조 표시하는 부분 구문이 아래에 있습니다.

아마도 모델 정의를 이해하는 가장 좋은 방법은 잘 알고 있는 테이블 형식 모델로 시작하는 것입니다. SQL Server Data Tools 코드 보기 옵션을 사용하여 해당 정의를 봅니다. 코드를 볼 수 있도록 JSON 편집기를 설치해야 합니다. Community Edition 또는 다른 버전의 Visual Studio 를 다운로드하여 Visual Studio에서 JSON 편집기를 가져올 수 있습니다.

참고

모든 스크립트에서 한 번에 하나의 데이터베이스만 참조할 수 있습니다. 데이터베이스 자체가 아닌 다른 개체의 경우 모델을 지정하는 경우 Database 속성은 선택 사항입니다. 명시적으로 제공되지 않은 경우 데이터베이스 이름을 추론하는 데 사용할 수 있는 모델과 데이터베이스 간에 일대일 매핑이 있습니다.
마찬가지로 데이터베이스에서 해당 속성을 설정하여 모델을 제외할 수 있습니다.

개체 정의

모든 개체에는 이름, 형식, 설명, 속성 컬렉션 및 주석을 비롯한 공통 속성 집합이 있습니다. 모델 개체에는 다음과 같은 속성도 있습니다.

storageLocation
모델을 배치할 디스크의 위치입니다.

defaultMode
데이터를 파티션에 사용할 수 있도록 하는 기본 메서드입니다.

defaultDataView
DirectQuery 모드의 모델의 경우 이 속성은 모델에 대해 쿼리를 실행하는 데 사용되는 파티션을 결정합니다. 유효한 값으로는 Full 및 Sample이 있습니다.

culture
서식 지정에 사용할 문화권입니다.

collation
데이터 정렬 시퀀스입니다.

테이블
파티션, 열, 측정값, KPI 및 주석을 포함하여 모델에 있는 테이블의 전체 컬렉션입니다. 자세한 내용은 Tables 개체(TMSL) 를 참조하세요.

relationships
필터 방향 및 보안을 설정하는 속성을 포함하여 각 테이블 쌍 간의 관계를 지정합니다. 자세한 내용은 Relationships 개체(TMSL) 를 참조하세요.

dataSources
모델에 데이터를 제공하거나 쿼리를 통과하는 데 사용되는 외부 데이터베이스에 대한 하나 이상의 연결입니다. 자세한 내용은 DataSources 개체(TMSL) 를 참조하세요.

역할
데이터베이스 권한, 멤버 계정 및 필요에 따라 사용자 지정 액세스 제어를 위한 DAX의 보안 필터를 연결하는 개체입니다.

사용량

모델 개체에는 전체 모델이 포함됩니다. 대부분의 명령에서 하나의 Model 및/또는 부모 Database 개체를 지정해야 합니다.

모델 개체를 만들거나 바꾸거나 변경할 때 개체 정의의 모든 읽기-쓰기 속성을 지정합니다. 읽기-쓰기 속성의 누락은 삭제로 간주됩니다.

부분 구문

이 개체 정의는 너무 커서 첫 번째 수준 속성만 나열됩니다. 자식 개체 목록은 TMSL(테이블 형식 모델 스크립팅 언어) 의 개체 정의를 참조하세요.

    "model": {  
      "description": "Model object of a tabular database",  
      "type": "object",  
      "properties": {  
          "name": {  },  
          "description": {  },  
         "storageLocation": {  },  
         "defaultMode":  {  },  
         "defaultDataView": {  },  
         "culture": {  },  
         "collation": {  },  
         "annotations": {  },  
         "tables": {  },  
         "relationships": {  },  
         "dataSources": {  },  
         "perspectives": {  },  
            "cultures": {  },  
         "roles": {  }  
    }