.create 수집 매핑 명령

특정 형식 및 특정 테이블 또는 데이터베이스와 연결할 수 있는 수집 매핑을 만듭니다.

지정된 범위에서 이름이 같은 매핑이 이미 있는 .create 경우 실패합니다. 대신 .create-or-alter를 사용하세요.

사용 권한

데이터베이스 수집 매핑을 만들려면 데이터베이스 수집 권한 이상이 필요하며 테이블 수집 매핑을 만들려면 테이블 수집 권한 이상이 필요합니다.

구문

.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.createdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름	Type	필수	설명
TableName	string	✔️	테이블의 이름입니다.
DatabaseName	string	✔️	데이터베이스의 이름입니다.
MappingKind	string	✔️	매핑의 형식입니다. 유효한 값은 csv, json, avro, parquet, orc입니다.
MappingName	string	✔️	매핑의 이름입니다.
MappingFormattedAsJson	string	✔️	JSON 값으로 형식이 지정된 수집 매핑 정의입니다.

참고 항목

• 매핑을 만든 후에는 명령의 일부로 전체 매핑을 지정하는 대신 수집 명령에서 해당 이름으로 매핑을 참조할 수 있습니다.
• 테이블 범위와 데이터베이스 범위 모두에서 이름이 같은 매핑이 만들어지면 테이블 범위의 매핑 우선 순위가 높아집니다.
• 테이블을 수집하고 스키마가 수집된 테이블 스키마와 일치하지 않는 매핑을 참조하는 경우 수집 작업이 실패합니다.

예제

.create table MyTable ingestion csv mapping "Mapping1"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

.create database MyDatabase ingestion csv mapping "Mapping2"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

출력

속성	종류	매핑	데이터베이스	테이블
mapping1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase	MyTable
mapping2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase

예: 이스케이프 문자를 사용하여 수집 매핑 만들기

.create table test_table ingestion json mapping "test_mapping_name"
'['
'{"column":"timeStamp","path":"$[\'timeStamp\']","datatype":"","transform":null},{"column":"name","path":"$[\'name\']","datatype":"","transform":null},{"column":"x-opt-partition-key","path":"$[\'x-opt-partition-key\']","datatype":"","transform":null}'
']'

관련 콘텐츠

• CSV, JSON, Avro, Parquet 및 Orc와 같은 다양한 수집 매핑 형식에 대한 자세한 설명은 데이터 매핑을 참조 하세요.