azurerm_log_analytics_workspace_table Allow deploying of DCR based custom log tables

[oWretch]

Community Note

• Please vote on this PR by adding a 👍 reaction to the original PR to help the community and maintainers prioritize for review
• Please do not leave comments along the lines of "+1", "me too" or "any updates", they generate extra noise for PR followers and do not help prioritize for review

Description

Enable the creation of DCR-based custom log tables in a Log Analytics workspace.

This PR will break the existing initial workflow of auto-importing a default Microsoft table when changing the retention policy. Instead of auto-importing, the resource will now return an ImportRequired error instead, forcing the inbuilt table to be imported.

To prevent further breakage, I have defined a default for the type property to be Microsoft, though this will cause a drift for any tables that were managed and not a Microsoft table. I have also defined the sub_type to be both Optional and Computed rather than creating a default to again uplift the existing usage of the resource where possible.

I had hoped to get this in before the release of v4.0, but just missed it. So I have conditioned the type and sub_type properties as Optional for 4.0 and Required for 5.0.

PR Checklist

• I have followed the guidelines in our Contributing Documentation.
• I have checked to ensure there aren't other open Pull Requests for the same update/change.
• I have checked if my changes close any open issues. If so please include appropriate closing keywords below.
• I have updated/added Documentation as required written in a helpful and kind way to assist users that may be unfamiliar with the resource / data source.
• I have used a meaningful PR title to help maintainers and other users understand this change and help prevent duplicate work.
  For example: “resource_name_here - description of change e.g. adding property new_property_name_here”

Changes to existing Resource / Data Source

• I have added an explanation of what my changes do and why I'd like you to include them (This may be covered by linking to an issue above, but may benefit from additional explanation).
• I have written new tests for my resource or datasource changes & updated any relevent documentation.
• I have successfully run tests with my changes locally. If not, please provide details on testing challenges that prevented you running the tests.
• (For changes that include a state migration only). I have manually tested the migration path between relevant versions of the provider.

Testing

• My submission includes Test coverage as described in the Contribution Guide and the tests pass. (if this is not possible for any reason, please include details of why you did or could not add test coverage)

TF_ACC=1 go test -v ./internal/services/loganalytics -run="TestAccLogAnalyticsWorkspaceTable_" -timeout 60m -ldflags="-X=github.com/hashicorp/terraform-provider-azurerm/version.ProviderVersion=acc"
=== RUN   TestAccLogAnalyticsWorkspaceTable_updateTableRetention
=== PAUSE TestAccLogAnalyticsWorkspaceTable_updateTableRetention
=== RUN   TestAccLogAnalyticsWorkspaceTable_plan
=== PAUSE TestAccLogAnalyticsWorkspaceTable_plan
=== RUN   TestAccLogAnalyticsWorkspaceTable_customDcr
=== PAUSE TestAccLogAnalyticsWorkspaceTable_customDcr
=== CONT  TestAccLogAnalyticsWorkspaceTable_updateTableRetention
=== CONT  TestAccLogAnalyticsWorkspaceTable_customDcr
=== CONT  TestAccLogAnalyticsWorkspaceTable_plan
--- PASS: TestAccLogAnalyticsWorkspaceTable_plan (248.69s)
--- PASS: TestAccLogAnalyticsWorkspaceTable_customDcr (260.43s)
--- PASS: TestAccLogAnalyticsWorkspaceTable_updateTableRetention (265.10s)
PASS
ok      github.com/hashicorp/terraform-provider-azurerm/internal/services/loganalytics  267.917s

Change Log

Below please provide what should go into the changelog (if anything) conforming to the Changelog Format documented here.

• azurerm_log_analytics_workspace_table - allow creating new DCR-based custom log tables [azurerm_log_analytics_workspace_table Allow deploying of DCR based custom log tables #27155]

This is a (please select all that apply):

• Bug Fix
• New Feature (ie adding a service, resource, or data source)
• Enhancement
• Breaking Change

Related Issue(s)

Fixes #21897

Note

If this PR changes meaningfully during the course of review please update the title and description as required.

[github-actions]

This PR is being labeled as "stale" because it has not been updated for 30 or more days.

If this PR is still valid, please remove the "stale" label. If this PR is blocked, please add it to the "Blocked" milestone.

If you need some help completing this PR, please leave a comment letting us know. Thank you!

[github-actions]

This PR is being labeled as "stale" because it has not been updated for 30 or more days.

If this PR is still valid, please remove the "stale" label. If this PR is blocked, please add it to the "Blocked" milestone.

If you need some help completing this PR, please leave a comment letting us know. Thank you!

[nclaeys]

@oWretch can you fix the linting errors and rebase? Maybe we can get this branch finally merged 🙏

[oWretch]

Thanks for the review @nclaeys.

As per the PR description, the reason for the linting error is:

To prevent further breakage, I have defined a default for the type property to be Microsoft, though this will cause a drift for any tables that were managed and not a Microsoft table. I have also defined the sub_type to be both Optional and Computed rather than creating a default to again uplift the existing usage of the resource where possible.

I had hoped to get this in before the release of v4.0, but just missed it. So I have conditioned the type and sub_type properties as Optional for 4.0 and Required for 5.0.

If we are happy to accept the plan diff for existing managed resource I can remove the Computed property from the sub_type property. Otherwise I'm open to other options as to how to uplift the existing resources without the linting problem.

[nclaeys]

@katbyte can you have a look? I really need this feature to be added to the provider. I want to help where needed to get this merged.

[nunoalima]

If I understood correctly, this PR closes:

• Support for creating a new table in Log Analytics workspace #23359.