[DS] Add mirrored database data-source

[OrBaubergMicrosoft]

📝 Description

When I am automating and managing data analytics infrastructure using Microsoft Fabric across multiple environments,
I want to get details of mirrored databases as code in Terraform.
To consistently and securely manage mirrored databases as code in Terraform while automating and managing data analytics infrastructure using Microsoft Fabric across multiple environments.

🔬 Details / References

• Data Source Name: fabric_mirrored_database
• API documentation:
  • Create Mirrored Database: https://learn.microsoft.com/en-us/rest/api/fabric/mirroreddatabase/items/create-mirrored-database?tabs=HTTP
  • Delete Mirrored Database: https://learn.microsoft.com/en-us/rest/api/fabric/mirroreddatabase/items/delete-mirrored-database?tabs=HTTP
  • List Mirrored Databases: https://learn.microsoft.com/en-us/rest/api/fabric/mirroreddatabase/items/list-mirrored-databases?tabs=HTTP
  • Update Mirrored Database: https://learn.microsoft.com/en-us/rest/api/fabric/mirroreddatabase/items/update-mirrored-database?tabs=HTTP
  • Get Mirrored Database: https://learn.microsoft.com/en-us/rest/api/fabric/mirroreddatabase/items/get-mirrored-database?tabs=HTTP
• Estimated complexity/effort: easy
• Related resources/data-sources: https://learn.microsoft.com/en-us/rest/api/fabric/articles/item-management/definitions/mirrored-database-definition

🚧 Potential Terraform Configuration / Desired Solution

Get item details by name

data "fabric_mirrored_database" "example_by_name" {
display_name = "example"
workspace_id = "00000000-0000-0000-0000-000000000000"
}

Get item details by id

data "fabric_mirrored_database" "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_mirrored_database" "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_mirrored_database.example_definition.definition["mirroring.json"].content)
}

Access the content of the definition as JSON object

output "example_definition_content_object" {
value = provider::fabric::content_decode(data.fabric_mirrored_database.example_definition.definition["mirroring.json"].content)
}

This is an invalid data source

Do not specify id and display_name in the same data source block

data "fabric_mirrored_database" "example" {

display_name = "example"

id = "11111111-1111-1111-1111-111111111111"

workspace_id = "00000000-0000-0000-0000-000000000000"

}

📎 Additional context

No response

☑️ Acceptance Criteria

No response

✅ Definition of Done

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