Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 10 additions & 9 deletions data-explorer/kusto/management/show-ingestion-mapping-command.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: .show ingestion mapping
description: Learn how to use the `.show ingestion mapping` command to view the ingestion mapping for a table or database.
title: The show ingestion mapping command
description: Learn how to use the show ingestion mapping command to view the ingestion mapping for a table or database.
ms.reviewer: orspodek
ms.topic: reference
ms.date: 08/11/2024
---
# .show ingestion mapping
# `.show ingestion mapping`

> [!INCLUDE [applies](../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../includes/applies-to-version/azure-data-explorer.md)]

Expand All @@ -27,13 +27,13 @@ View all mappings or all mappings of a specific type:

|Name|Type|Required|Description|
|--|--|--|--|
|*EntityName*| `string` | :heavy_check_mark:|The name of the table or database for which to show the ingestion mapping(s).|
|*MappingKind*| `string` ||The type of mapping(s) to view. Possible values: `csv`, `json`, `avro`, `w3clogfile`, `parquet`, and `orc`.|
|*EntityName*| `string` | :heavy_check_mark:|The name of the table or database for which to show the ingestion mappings.|
|*MappingKind*| `string` ||The type of mappings to view. Possible values: `csv`, `json`, `avro`, `w3clogfile`, `parquet`, and `orc`.|
|*MappingName*| `string` ||The name of the mapping to view. This argument is required if you specify that you want to view a single `mapping` instead of multiple `mappings` for the entity. See [syntax options](#syntax).|

## Returns

The command returns a table with the columns `Name`, `Kind`, and `Mapping` that describe the ingestion mapping(s) names, types, and specifications.
The command returns a table with the columns `Name`, `Kind`, and `Mapping` that describe one or more ingestion mappings names, types, and specifications.

## Example

Expand All @@ -49,10 +49,11 @@ The command returns a table with the columns `Name`, `Kind`, and `Mapping` that
|----------|------|-------------|
| mapping1 | CSV | `[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]` |

If the table only contained one CSV formatted mapping named "mapping1", the following query would return the same output as the previous query.
If the table only contained one CSV formatted mapping named `mapping1`, the following query would return the same output as the previous query.

```kusto
.show table MyTable ingestion csv mappings
```

```kusto
.show database MyDatabase ingestion csv mappings
Expand All @@ -61,5 +62,5 @@ If the table only contained one CSV formatted mapping named "mapping1", the foll
## Related content

* Learn more about [data mappings](mappings.md)
* Use [.create ingestion mapping](create-ingestion-mapping-command.md) to create a new mapping
* Use [.alter ingestion mapping](alter-ingestion-mapping-command.md) to change an existing mapping
* Use the [`.create ingestion mapping`](create-ingestion-mapping-command.md) command to create a new mapping
* Use the [`.alter ingestion mapping`](alter-ingestion-mapping-command.md) command to change an existing mapping