From d464a4f3e6bfd95badddf1233ea301e238855e10 Mon Sep 17 00:00:00 2001
From: ktalmor <193799742+ktalmor@users.noreply.github.com>
Date: Tue, 12 May 2026 12:46:39 +0300
Subject: [PATCH 1/8] Remove GDPR include from multitenant doc
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
data-explorer/multi-tenant.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/data-explorer/multi-tenant.md b/data-explorer/multi-tenant.md
index 301c4a1ea7..d4e599480b 100644
--- a/data-explorer/multi-tenant.md
+++ b/data-explorer/multi-tenant.md
@@ -73,9 +73,7 @@ The characteristics of this architecture are:
* **Provisioning a new tenant**: Provisioning a new tenant doesn't require any database creation or schema adjustment. The new **tenant ID** is used in new records.
-* **Removing a tenant**: Requires a [soft delete](/kusto/concepts/data-soft-delete?view=azure-data-explorer&preserve-view=true) or [purge](/kusto/concepts/data-purge?view=azure-data-explorer&preserve-view=true) of the tenant's data. A soft delete is more efficient, while purge supports GDPR obligations. You can batch multiple purges together, for example, at the end of week to limit the impact on resource consumption.
-
- [!INCLUDE [gdpr-intro-sentence](includes/gdpr-intro-sentence.md)]
+* **Removing a tenant**: Requires a [soft delete](/kusto/concepts/data-soft-delete?view=azure-data-explorer&preserve-view=true) or [purge](/kusto/concepts/data-purge?view=azure-data-explorer&preserve-view=true) of the tenant's data. You can batch multiple purges together, for example, at the end of week to limit the impact on resource consumption.
* **Database schemas updates**: All tenants' schema are upgraded at the same time. Since all tenants share table, changing table schemas changes all tenants at once.
From 982e758c13b0f27d92b5d3bea38addc8fcb2d49b Mon Sep 17 00:00:00 2001
From: ktalmor <193799742+ktalmor@users.noreply.github.com>
Date: Tue, 12 May 2026 14:14:36 +0300
Subject: [PATCH 2/8] create includes file; update artwork
---
.../includes/cross-repo/multitenancy.md | 96 ++++++++++++++++++
.../multitenant/one-db-for-many-tenants.png | Bin 0 -> 33460 bytes
.../media/multitenant/one-tenant-per-db.png | Bin 0 -> 29356 bytes
.../multitenant/one-tenant-per-table.png | Bin 0 -> 22009 bytes
.../multitenant/one-db-for-many-tenants.png | Bin 20697 -> 0 bytes
.../media/multitenant/one-tenant-per-db.png | Bin 26444 -> 0 bytes
.../multitenant/one-tenant-per-table.png | Bin 17058 -> 0 bytes
data-explorer/multi-tenant.md | 92 +----------------
8 files changed, 97 insertions(+), 91 deletions(-)
create mode 100644 data-explorer/includes/cross-repo/multitenancy.md
create mode 100644 data-explorer/includes/media/multitenant/one-db-for-many-tenants.png
create mode 100644 data-explorer/includes/media/multitenant/one-tenant-per-db.png
create mode 100644 data-explorer/includes/media/multitenant/one-tenant-per-table.png
delete mode 100644 data-explorer/media/multitenant/one-db-for-many-tenants.png
delete mode 100644 data-explorer/media/multitenant/one-tenant-per-db.png
delete mode 100644 data-explorer/media/multitenant/one-tenant-per-table.png
diff --git a/data-explorer/includes/cross-repo/multitenancy.md b/data-explorer/includes/cross-repo/multitenancy.md
new file mode 100644
index 0000000000..40dba4162e
--- /dev/null
+++ b/data-explorer/includes/cross-repo/multitenancy.md
@@ -0,0 +1,96 @@
+---
+ms.topic: include
+ms.date: 05/12/2026
+---
+
+The concept of multi-tenancy in Azure Data Explorer refers to serving different tenants and storing their data in a single cluster.
+
+> [!IMPORTANT]
+>
+> A multitenant solution can also be architected in Microsoft Fabric's [Real-Time Intelligence](/fabric/real-time-intelligence/overview) workload, using KQL databases inside an [Eventhouse](/fabric/real-time-intelligence/eventhouse).
+
+A *tenant* can represent a customer, a group of users, or any classifications of users where data needs to be segregated along the tenants' boundaries. You can also have multi-level multi-tenancy scenario, such as multiple applications that each have multiple tenants. This scenario isn't covered by this article but similar principles apply.
+
+An important factor is the way end-users access their tenant data. When end-users access Azure Data Explorer directly, access control must be configured in Azure Data Explorer to isolate the user's view to their own data. When a proxy application accesses their data in Azure Data Explorer, the application can do the isolation.
+
+This article describes some deployment architectures and provides characteristics for each. You can use the characteristics to help you decide which architecture works best for your solution.
+
+## Noisy neighbor
+
+In general, sharing a cluster among many tenants, regardless of the architecture used, means different tenants share the cluster's resources. This can lead to the [noisy neighbor](/azure/architecture/antipatterns/noisy-neighbor/noisy-neighbor) antipattern.
+
+For instance, if a tenant performs many compute-intensive queries or ingestions, other tenants are likely to be impacted by resource starvation. This can be mitigated by using [workload groups](/kusto/management/workload-groups?view=azure-data-explorer&preserve-view=true). You can also use policies to control caching and overall storage.
+
+## Architectures overview
+
+The next sections explore deployment architectures in detail. This section contrasts the architectures to facilitate decision making.
+
+|Architecture|Strengths|
+|---|---|
+|One tenant per database|- Tenants' isolation: no need for proxy
- Can have different policies, such as retention policies, per tenant
- Flexibility in schema evolution per tenant
- Easy and quick removal of tenant data|
+|One table for many tenants|- Efficient data consolidation and extent management
- Simplified schema evolution
- Best suited for materialized views
- Ideal for partitioning|
+|One tenant per table in a single database|Not recommended|
+
+## Architecture: One tenant per database
+
+:::image type="content" source="../media/multitenant/one-tenant-per-db.png" alt-text="Diagram showing the architecture for one tenant per database.":::
+
+This is a popular and straight forward architecture. Each tenant gets its own database. Each database has the same schema.
+
+The characteristics of this architecture are:
+
+* **Provisioning a new tenant**: Requires creating a new database and [deploying schema entities](automated-deploy-overview.md#deploy-schema-entities) on it.
+
+* **Removing a tenant**: Requires deleting the database. Deleting a database can be done in a few seconds. Consumes little and constant resources that aren't linear with tenant's data volume.
+
+* **Database schemas updates**: Each tenant can be independently updated at different times. Applications that access the databases must be aware of the version of each database they interact with.
+
+* **Retention and caching policies**: Each tenant can have its own unique policies, which enable you to provide custom retention and caching policies to your customers.
+
+* **Security boundary per tenant**:
+ * For multitenant application (proxy): Configure your application to target the relevant database. Use [access restriction](/kusto/query/cross-cluster-or-database-queries?view=azure-data-explorer&preserve-view=true#qualified-names-and-restrict-access-statements) on queries to prohibit [cross-database queries](/kusto/query/cross-cluster-or-database-queries?view=azure-data-explorer&preserve-view=true).
+ * For users with direct access: Users can be granted access at the [database level](/kusto/access-control/role-based-access-control?view=azure-data-explorer&preserve-view=true). Giving users direct access to their database creates a dependency for the implementation details, making it difficult to change the implementation. Therefore, we strongly recommend using the proxy approach for accessing the database.
+
+* **Aggregating data from multiple tenants at scale**: Use the [union operator](/kusto/query/union-operator?view=azure-data-explorer&preserve-view=true) to aggregate data between databases. However, this method can become cumbersome as the number of tenants increases. Even though aggregating data from multiple tenants might be a design goal from the tenant's perspective, it might be of interest for solution owner to aggregate data from all tenants to gather statistics.
+
+* **Extents fragmentation**: Each tenant ingesting a few records per database table leads to the creation of small [extents](/kusto/management/extents-overview?view=azure-data-explorer&preserve-view=true) that later need to be merged. This results in higher cost for extent management. Therefore, we strongly recommend using [streaming ingestion](ingest-data-streaming.md), such as Event Hubs or Event Grid ingestion. To use streaming ingestion, you must make sure it's enabled on the cluster and table.
+
+* **Materialized views and partitioning policy**. As number of tenants increases, it's important to remember that there are limits to the number of [materialized views](/kusto/management/materialized-views/materialized-view-overview?view=azure-data-explorer&preserve-view=true#performance-considerations) and [partition policies](/kusto/management/partitioning-policy?view=azure-data-explorer&preserve-view=true#supported-scenarios) a cluster can run efficiently.
+
+* **Event Grid and Event Hubs data connections**: These data connections are created per database. Therefore, this architecture requires a data connection and Event Grid or Event Hubs instance per tenant, which adds management complexity. Consider using event routing for [Event Hubs](ingest-data-event-hub-overview.md#events-routing) and [Event Grid](ingest-data-event-grid-overview.md#events-routing).
+
+## Architecture: One table for many tenants
+
+:::image type="content" source="../media/multitenant/one-db-for-many-tenants.png" alt-text="Diagram showing the architecture for one database for many tenants.":::
+
+This architecture is more aggressive in its consolidation, using a single database for all tenants. Each table in the database has a **Tenant ID** column, or equivalent, which allows for filtering for a single tenant's data. You can [partition](/kusto/management/partitioning-policy?view=azure-data-explorer&preserve-view=true) tables by tenant to improve query performance, since most queries are likely to filter by tenant. Where possible, you should consider partition with another column using a *compound* partition key. For example, you can create a *compound* partition key concatenating the **tenant ID** and another columns' values.
+
+The characteristics of this architecture are:
+
+* **Provisioning a new tenant**: Provisioning a new tenant doesn't require any database creation or schema adjustment. The new **tenant ID** is used in new records.
+
+* **Removing a tenant**: Requires a [soft delete](/kusto/concepts/data-soft-delete?view=azure-data-explorer&preserve-view=true) or [purge](/kusto/concepts/data-purge?view=azure-data-explorer&preserve-view=true) of the tenant's data. You can batch multiple purges together, for example, at the end of week to limit the impact on resource consumption.
+
+* **Database schemas updates**: All tenants' schema are upgraded at the same time. Since all tenants share table, changing table schemas changes all tenants at once.
+
+* **Retention and caching policies**: The policies are the same for all tenants since they all share the same table.
+
+* **Security boundary per tenant**:
+ * For multitenant application (proxy): Use the [Restrict statement](/kusto/query/restrict-statement?view=azure-data-explorer&preserve-view=true)
+ * For users with direct access: Use the [Row Level Security Policy](/kusto/management/row-level-security-policy) and familiarize yourself with its [limitations](/kusto/management/row-level-security-policy?view=azure-data-explorer&preserve-view=true#limitations). Giving users direct access to their database creates a dependency for the implementation details, making it difficult to change the implementation. Therefore, we strongly recommend using the proxy approach for accessing the database.
+
+* **Aggregating data from multiple tenants at scale**: Users with the sufficient access permissions can run a standard aggregation query on multiple tenants' data.
+
+* **Extents fragmentation**: Since all tenants ingest data into the same table, data can usually be consolidated and efficiently ingested in one, or a few, extents.
+
+* **Materialized views and partitioning policy**: These can be used on multitenant table. You can improve performance by partitioning on the **Tenant ID**, or equivalent, column. For more information, see [Scenarios for partition policies](/kusto/management/partitioning-policy?view=azure-data-explorer&preserve-view=true#supported-scenarios).
+
+* **Event Grid and Event Hubs data connections**: You consolidated data connections since data for all tenants ends up in one table.
+
+## Architecture: One tenant per table in a single database
+
+:::image type="content" source="../media/multitenant/one-tenant-per-table.png" alt-text="Diagram showing the architecture for one tenant per table.":::
+
+This architecture is a combination of the previous architectures where the data of all tenants ends up in a single database but separate tables. This architecture fails to capture all the advantages of the other architectures.
+
+Although each tenant's data is segregated, they all reside in the same security context of the same database. Like the multi-database architecture, this architecture can lead to extent fragmentation. The table name is different for each tenant and therefore the queries must be customized for each tenant.
diff --git a/data-explorer/includes/media/multitenant/one-db-for-many-tenants.png b/data-explorer/includes/media/multitenant/one-db-for-many-tenants.png
new file mode 100644
index 0000000000000000000000000000000000000000..dd4439d8e7ce3620b8573eaa3834fb3e7eac1cab
GIT binary patch
literal 33460
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