azure-data-explorer
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure Data Explorer Skill
Azure Data Explorer Skill
This skill provides expert guidance for Azure Data Explorer. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
本Skill为Azure Data Explorer提供专业指导,涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署。它结合了本地快速参考内容与远程文档获取能力。
How to Use This Skill
如何使用本Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,), useL35-L120with the specified lines. For categories with file links (e.g.,read_file), use[security.md](security.md)on the linked reference fileread_file
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
Agent注意事项:使用下方的分类索引定位相关章节。对于带有行范围的分类(例如),使用L35-L120读取指定行。对于带有文件链接的分类(例如read_file),使用[security.md](security.md)读取链接的参考文件read_file
本Skill需要网络访问权限来获取文档内容:
- 首选方式:使用,查询字符串为
mcp_microsoftdocs:microsoft_docs_fetch,返回Markdown格式内容。from=learn-agent-skill - 备用方式:使用,查询字符串为
fetch_webpage,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L48 | Diagnosing and fixing ADX cluster health, creation, connection, private endpoint, ingestion, and DB/table operation errors, including interpreting ingestion error codes and using Resource Health. |
| Best Practices | L49-L59 | Guidance on ADX performance and reliability: schema design, handling duplicates, JSON ingestion, monitoring queued ingestion, hot/cold data querying, high concurrency, and Power BI integration. |
| Decision Making | L60-L74 | Guidance on ADX cluster sizing and SKUs, cost and reservations, business continuity, confidential/isolated compute, streaming ingestion choices, and migrating from Elasticsearch. |
| Architecture & Design Patterns | L75-L81 | Patterns for ADX deployment: regional DR and replication, cross-cluster access via follower DBs, and multitenant cluster/database design choices. |
| Limits & Quotas | L82-L92 | Cluster limits and behaviors: free cluster quotas, auto-stop, safe delete/recover, ingestion file size and invalid data handling, and supported data/compression formats. |
| Security | L93-L120 | Configuring ADX security: auth/RBAC, managed identities, encryption/CMK, network isolation (private endpoints, outbound/public access), policies, compliance, and data privacy (purge). |
| Configuration | L121-L136 | Configuring ADX clusters, schemas, policies, plugins, and data connections, plus emulator setup, KQL/T-SQL use, monitoring refs, and web UI settings/profiles/shortcuts. |
| Integrations & Coding Patterns | L137-L170 | Integrating ADX with tools and services (SQL, ODBC/JDBC, Power Automate/Apps, Functions, Grafana, Splunk, OpenTelemetry, Tableau, MATLAB, etc.) and coding/query patterns for those connections. |
| Deployment | L171-L177 | Provisioning and automating ADX environments, deploying schema via Azure DevOps, and migrating clusters to availability zones and from VNet injection to private endpoints. |
| 分类 | 行范围 | 描述 |
|---|---|---|
| 故障排除 | L37-L48 | 诊断并修复ADX集群健康、创建、连接、专用终结点、数据摄入以及数据库/表操作错误,包括解读摄入错误代码和使用资源健康功能。 |
| 最佳实践 | L49-L59 | ADX性能与可靠性指导:架构设计、重复数据处理、JSON数据摄入、队列摄入监控、冷热数据查询、高并发以及Power BI集成。 |
| 决策制定 | L60-L74 | ADX集群规模与SKU选择、成本与预留实例、业务连续性、机密/隔离计算、流式摄入选择以及从Elasticsearch迁移的指导。 |
| 架构与设计模式 | L75-L81 | ADX部署模式:区域灾难恢复与复制、通过跟随数据库实现跨集群访问、多租户集群/数据库设计选择。 |
| 限制与配额 | L82-L92 | 集群限制与行为:免费集群配额、自动停止、安全删除/恢复、摄入文件大小与无效数据处理、支持的数据/压缩格式。 |
| 安全 | L93-L120 | 配置ADX安全:身份验证/RBAC、托管标识、加密/CMK、网络隔离(专用终结点、出站/公共访问)、策略、合规性以及数据隐私(清除)。 |
| 配置 | L121-L136 | 配置ADX集群、架构、策略、插件以及数据连接,此外还有模拟器设置、KQL/T-SQL使用、监控参考以及Web UI设置/配置文件/快捷键。 |
| 集成与编码模式 | L137-L170 | 将ADX与工具和服务集成(SQL、ODBC/JDBC、Power Automate/Apps、Functions、Grafana、Splunk、OpenTelemetry、Tableau、MATLAB等),以及这些连接的编码/查询模式。 |
| 部署 | L171-L177 | 预配并自动化ADX环境、通过Azure DevOps部署架构、将集群迁移到可用性区域以及从VNet注入迁移到专用终结点。 |
Troubleshooting
故障排除
| 主题 | URL |
|---|---|
| 监控并排查Azure Data Explorer集群健康问题 | https://learn.microsoft.com/en-us/azure/data-explorer/check-cluster-health |
| 解读ADX数据摄入错误代码与失败原因 | https://learn.microsoft.com/en-us/azure/data-explorer/error-codes |
| 解决Azure Data Explorer常见数据摄入问题 | https://learn.microsoft.com/en-us/azure/data-explorer/ingestion-faq |
| 使用资源健康功能排查ADX问题 | https://learn.microsoft.com/en-us/azure/data-explorer/monitor-with-resource-health |
| 排查Azure Data Explorer专用终结点问题 | https://learn.microsoft.com/en-us/azure/data-explorer/security-network-private-endpoint-troubleshoot |
| 修复Azure Data Explorer集群连接问题 | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-connect-cluster |
| 排查Azure Data Explorer集群创建失败问题 | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-create-cluster |
| 解决Azure Data Explorer数据库与表操作失败问题 | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-database-table |
Best Practices
最佳实践
| Topic | URL |
|---|---|
| Handle duplicate data in Azure Data Explorer | https://learn.microsoft.com/en-us/azure/data-explorer/dealing-with-duplicates |
| Optimize Azure Data Explorer clusters for high-concurrency workloads | https://learn.microsoft.com/en-us/azure/data-explorer/high-concurrency |
| Use hot windows to efficiently query cold data in Azure Data Explorer | https://learn.microsoft.com/en-us/azure/data-explorer/hot-windows |
| Ingest JSON into Azure Data Explorer with KQL, C#, and Python | https://learn.microsoft.com/en-us/azure/data-explorer/ingest-json-formats |
| Monitor queued ingestion metrics in ADX | https://learn.microsoft.com/en-us/azure/data-explorer/monitor-queued-ingestion |
| Apply Power BI best practices for Azure Data Explorer | https://learn.microsoft.com/en-us/azure/data-explorer/power-bi-best-practices |
| Optimize Azure Data Explorer table schema design | https://learn.microsoft.com/en-us/azure/data-explorer/schema-best-practice |
| 主题 | URL |
|---|---|
| 在Azure Data Explorer中处理重复数据 | https://learn.microsoft.com/en-us/azure/data-explorer/dealing-with-duplicates |
| 优化Azure Data Explorer集群以应对高并发工作负载 | https://learn.microsoft.com/en-us/azure/data-explorer/high-concurrency |
| 使用热窗口高效查询Azure Data Explorer中的冷数据 | https://learn.microsoft.com/en-us/azure/data-explorer/hot-windows |
| 通过KQL、C#和Python将JSON数据摄入Azure Data Explorer | https://learn.microsoft.com/en-us/azure/data-explorer/ingest-json-formats |
| 监控ADX中的队列摄入指标 | https://learn.microsoft.com/en-us/azure/data-explorer/monitor-queued-ingestion |
| 应用Azure Data Explorer的Power BI最佳实践 | https://learn.microsoft.com/en-us/azure/data-explorer/power-bi-best-practices |
| 优化Azure Data Explorer表架构设计 | https://learn.microsoft.com/en-us/azure/data-explorer/schema-best-practice |
Decision Making
决策制定
Architecture & Design Patterns
架构与设计模式
| Topic | URL |
|---|---|
| Design ADX regional DR and replication solutions | https://learn.microsoft.com/en-us/azure/data-explorer/business-continuity-create-solution |
| Use follower databases for cross-cluster ADX access | https://learn.microsoft.com/en-us/azure/data-explorer/follower |
| Choose multitenant architectures for Azure Data Explorer | https://learn.microsoft.com/en-us/azure/data-explorer/multi-tenant |
| 主题 | URL |
|---|---|
| 设计ADX区域灾难恢复与复制解决方案 | https://learn.microsoft.com/en-us/azure/data-explorer/business-continuity-create-solution |
| 使用跟随数据库实现ADX跨集群访问 | https://learn.microsoft.com/en-us/azure/data-explorer/follower |
| 为Azure Data Explorer选择多租户架构 | https://learn.microsoft.com/en-us/azure/data-explorer/multi-tenant |
Limits & Quotas
限制与配额
| Topic | URL |
|---|---|
| Understand automatic stop behavior for inactive clusters | https://learn.microsoft.com/en-us/azure/data-explorer/auto-stop-clusters |
| Apply Event Grid ingestion file size limits in Azure Data Explorer | https://learn.microsoft.com/en-us/azure/data-explorer/create-event-grid-connection |
| Delete and recover Azure Data Explorer clusters safely | https://learn.microsoft.com/en-us/azure/data-explorer/delete-cluster |
| Understand invalid data behavior during ADX ingestion | https://learn.microsoft.com/en-us/azure/data-explorer/ingest-invalid-data |
| Supported data and compression formats for Azure Data Explorer ingestion | https://learn.microsoft.com/en-us/azure/data-explorer/ingestion-supported-formats |
| Use Azure Data Explorer free cluster limits | https://learn.microsoft.com/en-us/azure/data-explorer/start-for-free |
| Upgrade free Azure Data Explorer clusters and remove limits | https://learn.microsoft.com/en-us/azure/data-explorer/start-for-free-upgrade |
| 主题 | URL |
|---|---|
| 了解非活动集群的自动停止行为 | https://learn.microsoft.com/en-us/azure/data-explorer/auto-stop-clusters |
| 应用Azure Data Explorer中Event Grid摄入文件大小限制 | https://learn.microsoft.com/en-us/azure/data-explorer/create-event-grid-connection |
| 安全删除并恢复Azure Data Explorer集群 | https://learn.microsoft.com/en-us/azure/data-explorer/delete-cluster |
| 了解ADX数据摄入期间的无效数据处理行为 | https://learn.microsoft.com/en-us/azure/data-explorer/ingest-invalid-data |
| Azure Data Explorer数据摄入支持的数据与压缩格式 | https://learn.microsoft.com/en-us/azure/data-explorer/ingestion-supported-formats |
| 使用Azure Data Explorer免费集群限制 | https://learn.microsoft.com/en-us/azure/data-explorer/start-for-free |
| 升级Azure Data Explorer免费集群并移除限制 | https://learn.microsoft.com/en-us/azure/data-explorer/start-for-free-upgrade |
Security
安全
Configuration
配置
Integrations & Coding Patterns
集成与编码模式
Deployment
部署
| Topic | URL |
|---|---|
| Automate provisioning of Azure Data Explorer environments | https://learn.microsoft.com/en-us/azure/data-explorer/automated-deploy-overview |
| Use Azure DevOps pipelines for Azure Data Explorer schema deployment | https://learn.microsoft.com/en-us/azure/data-explorer/devops |
| Migrate Azure Data Explorer clusters to availability zones | https://learn.microsoft.com/en-us/azure/data-explorer/migrate-cluster-to-multiple-availability-zone |
| Migrate Azure Data Explorer VNet injection to private endpoints | https://learn.microsoft.com/en-us/azure/data-explorer/security-network-migrate-vnet-to-private-endpoint |
| 主题 | URL |
|---|---|
| 自动化预配Azure Data Explorer环境 | https://learn.microsoft.com/en-us/azure/data-explorer/automated-deploy-overview |
| 使用Azure DevOps管道进行Azure Data Explorer架构部署 | https://learn.microsoft.com/en-us/azure/data-explorer/devops |
| 将Azure Data Explorer集群迁移到可用性区域 | https://learn.microsoft.com/en-us/azure/data-explorer/migrate-cluster-to-multiple-availability-zone |
| 将Azure Data Explorer从VNet注入迁移到专用终结点 | https://learn.microsoft.com/en-us/azure/data-explorer/security-network-migrate-vnet-to-private-endpoint |