.create ingestion mapping コマンド

特定の形式と特定のテーブル*やデータベース*に関連付けられる、インジェスト* マッピング*を作成します。

指定されたスコープに同じ名前のマッピングが既に存在する場合、 .create は失敗します。 代わりに、.create-or-alter を使用してください。

アクセス許可

データベース インジェスト マッピングを作成するには、少なくとも Database Ingestor のアクセス許可が必要です。また、テーブル インジェスト マッピングを作成するには、少なくとも Table Ingestor のアクセス許可が必要です。

構文

.createtableTableNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabaseNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
TableName	string	✔️	テーブルの名前。
DatabaseName	string	✔️	データベースの名前。
MappingKind	string	✔️	マッピングの種類。 有効な値は、csv、json、avro、parquet、またはorc です。
Mappingname	string	✔️	マッピングの名前。
MappingFormattedAsJson	string	✔️	JSON 値として書式設定されたインジェスト マッピング定義。

Note

• 作成されたマッピング*は、コマンドの一部に完全なマッピングを指定するのではなく、インジェスト* コマンド内のマッピング名で参照*されます。
• テーブル*のスコープ*とデータベース*のスコープ*の両方で同じ名前のマッピングが作成された場合、テーブル*のスコープ*のマッピング*がより優先されます。
• テーブル*にマッピングを取り込み、マッピング*のスキーマが取り込まれたテーブル*のスキーマ*と一致しないことを参照すると、取り込み操作*は失敗します。

例

.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 インジェスト* マッピング*

.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 などのさまざまなインジェスト マッピング形式の詳細については、データ マッピングに関する記事を参照してください。