[DS-DEF] Enhance KQL Queryset item data-source by adding definition support

[DariuszPorowski]

📝 Description

When I am managing my Infrastructure as Code using Terraform for KQL Queryset. I want to be able to get details of KQL Queryset definition. So, I can use it as input to another resource/data-source.

🔬 Details / References

• Data Source Name: fabric_kql_queryset
• API documentation:
  • https://learn.microsoft.com/en-us/rest/api/fabric/kqlqueryset/items/get-kql-queryset
  • https://learn.microsoft.com/en-us/rest/api/fabric/kqlqueryset/items/get-kql-queryset-definition
  • https://learn.microsoft.com/en-us/rest/api/fabric/articles/item-management/definitions/kql-queryset-definition
• Estimated complexity/effort: easy
• Related resources/data sources: enhancement to existing fabric_kql_queryset data-source https://registry.terraform.io/providers/microsoft/fabric/latest/docs/data-sources/kql_queryset

🚧 Potential Terraform Configuration / Desired Solution

# Get item details by name
data "fabric_kql_queryset" "example_by_name" {
  display_name = "example"
  workspace_id = "00000000-0000-0000-0000-000000000000"
}

# Get item details by id
data "fabric_kql_queryset" "example_by_id" {
  id           = "11111111-1111-1111-1111-111111111111"
  workspace_id = "00000000-0000-0000-0000-000000000000"
}

# Get item details with definition
# Examples uses `id` but `display_name` can be used as well
data "fabric_kql_queryset" "example_definition" {
  id                = "11111111-1111-1111-1111-111111111111"
  workspace_id      = "00000000-0000-0000-0000-000000000000"
  output_definition = true
}

# Access the content of the definition with JSONPath expression
output "example_definition_content_jsonpath" {
  value = provider::fabric::content_decode(data.fabric_kql_queryset.example_definition.definition["RealTimeQueryset.json"].content)
}

# Access the content of the definition as JSON object
output "example_definition_content_object" {
  value = provider::fabric::content_decode(data.fabric_kql_queryset.example_definition.definition["RealTimeQueryset.json"].content)
}

# This is an invalid data source
# Do not specify `id` and `display_name` in the same data source block
# data "fabric_kql_queryset" "example" {
#   display_name = "example"
#   id           = "11111111-1111-1111-1111-111111111111"
#   workspace_id = "00000000-0000-0000-0000-000000000000"
# }

📎 Additional context

No response

✅ Definition of Done

• Data Transfer Objects (DTOs)
• Data Client functions
• Data Source Implementation
• Data Source 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.