.create ingestion mapping 명령

  • 아티클

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

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

사용 권한

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

Syntax

.createtableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

구문 규칙에 대해 자세히 알아보세요.

매개 변수

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

참고

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

예제

.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"}}'
']'

출력

Name 종류 매핑 데이터베이스 테이블
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}'
']'

관련 콘텐츠