[RS-DEF] Integrate KQL Queryset as Fabric Item with Definition resource

[DariuszPorowski]

📝 Description

When I am managing my Infrastructure as Code using Terraform. I want to be able to create, update, and manage KQL Querysets within my Microsoft Fabric platform. So, I can automate the deployment and configuration of my data querying capabilities, ensuring consistency, and reducing manual effort.

🔬 Details / References

• Resource Name: fabric_kql_queryset
• API documentation:
  • https://learn.microsoft.com/en-us/rest/api/fabric/kqlqueryset/items
  • https://learn.microsoft.com/en-us/rest/api/fabric/articles/item-management/definitions/kql-queryset-definition
• Estimated complexity/effort: easy
• Related resources/data sources:
  • [DS-DEF] Enhance KQL Queryset item data-source by adding definition support #131

Definition

• Definition is optional
• Format is N/A
• Empty definition part with Fabric path RealTimeQueryset.json contains: {}

Auth

• Service supports SPN

🚧 Potential Terraform Configuration / Desired Solution

# Example 1 - KQL Queryset without definition
resource "fabric_kql_queryset" "example" {
  display_name = "example"
  workspace_id = "00000000-0000-0000-0000-000000000000"
}

# Example 2 - KQL Queryset with definition bootstrapping only
resource "fabric_kql_queryset" "example_definition_bootstrap" {
  display_name              = "example"
  description               = "example with definition bootstrapping"
  workspace_id              = "00000000-0000-0000-0000-000000000000"
  definition_update_enabled = false
  definition = {
    "RealTimeQueryset.json" = {
      source = "${local.path}/RealTimeQueryset.json.tmpl"
    }
  }
}

# Example 3 - KQL Queryset with definition update when source or tokens changed
resource "fabric_kql_queryset" "example_definition_update" {
  display_name = "example"
  description  = "example with definition update when source or tokens changed"
  workspace_id = "00000000-0000-0000-0000-000000000000"
  definition = {
    "RealTimeQueryset.json" = {
      source = "${local.path}/RealTimeQueryset.json.tmpl"
      tokens = {
        "MESSAGE" = "World"
        "MyValue" = "Lorem Ipsum"
      }
    }
  }
}

📎 Additional context

No response

✅ Definition of Done

• Data Transfer Objects (DTOs)
• Data Client functions
• Resource Implementation
• Resource Added to Provider
• Unit Tests for Happy path
• Unit Tests for Error path
• Acceptance Tests
• Example in the ./examples folder
• Schema documentation in code
• Updated auto-generated provider docs with task docs

🔰 Code of Conduct

• I agree to follow this project's Code of Conduct.