feat: Add data-source google_oracle_database_goldengate_deployment_environments

[swethamagesh14]

Part of Issue

Release Note Template for Downstream PRs (will be copied)

See Write release notes for guidance.

`google_oracle_database_goldengate_deployment_environments`

[github-actions]

Googlers: For automatic test runs see go/terraform-auto-test-runs.

@BBBmau, a repository maintainer, has been assigned to review your changes. If you have not received review feedback within 2 business days, please leave a comment on this PR asking them to take a look.

You can help make sure that review is quick by doing a self-review and by running impacted tests locally.

[modular-magician]

Hi there, I'm the Modular magician. I've detected the following information about your changes for commit 0ef4b0a:

Diff report

Your PR generated the following diffs in downstream repositories:

Repository	Diff Link	Changes
google provider	View Diff	2 files changed, 239 insertions(+)
google-beta provider	View Diff	2 files changed, 239 insertions(+)

Missing doc report (experimental)

The following data sources are missing documents:

• google_oracle_database_goldengate_deployment_environments, expect file /website/docs/d/oracle_database_goldengate_deployment_environments.html.markdown to exist.

Test report

Analytics

Total Tests	Passed	Skipped	Affected
30	28	2	0

Affected Service Packages

• oracledatabase

Learn how VCR tests work

---

Step 1: Replaying Mode

🟢 All tests passed in Replaying mode! No Recording was needed.

View the replaying VCR build log

@swethamagesh14, @BBBmau VCR tests complete for 0ef4b0a!

[BBBmau]

I'll need a bit more context surrounding the oralce database since I couldn't find much documentation about this resource on the first review.

Some questions I have:

• This PR introduces a plural datasource, though I would prefer we introduce a singular data source first before adding in plural
• Do we not have the ability to create a deployment environment? We should instead add resource support and follow-up with this PR that adds singluar data source as it will allow us to reuse the schema, reducing duplicate code from occurring
• docs are missing in this PR, we should provide links / guides that assist in using this deployment environment (this could also be applied to the resource itself and not the datasource)

[swethamagesh14]

I'll need a bit more context surrounding the oralce database since I couldn't find much documentation about this resource on the first review.

Some questions I have:

• This PR introduces a plural datasource, though I would prefer we introduce a singular data source first before adding in plural
• Do we not have the ability to create a deployment environment? We should instead add resource support and follow-up with this PR that adds singluar data source as it will allow us to reuse the schema, reducing duplicate code from occurring
• docs are missing in this PR, we should provide links / guides that assist in using this deployment environment (this could also be applied to the resource itself and not the datasource)

Strictly read-only: In the upstream API, goldengateDeploymentEnvironments is a read-only metadata catalog managed by Oracle/Google. Since there are no CRUD endpoints (no create, update, or delete RPCs), it can only be queried and can't actually be represented as a Terraform resource.
Plural lookup design: The real resources users manage are deployments, connections, and assignments. To create those, you query this data source to list the available platform specs. This behaves similarly to read-only search queries in Terraform for our other datasources

To create a Goldengate Deployment resource, you need metadata from deploymentEnvironment datasource to put in the right values.

Links:
https://docs.oracle.com/en-us/iaas/api/#/en/goldengate/20200407/DeploymentEnvironmentCollection/ListDeploymentEnvironments
https://docs.oracle.com/en/cloud/paas/goldengate-service/druyg/
https://docs.cloud.google.com/oracle/database/docs/deploy-and-connect
https://docs.cloud.google.com/oracle/database/docs/overview

[BBBmau]

Thanks for the explanation and links! This makes sense now given that this is strictly focusing on fetching the environments of the goldengate deployment.

We are still missing docs, once these are added i can approve and merge 👍🏼

[modular-magician]

Hi there, I'm the Modular magician. I've detected the following information about your changes for commit 9834d07:

Diff report

Your PR generated the following diffs in downstream repositories:

Repository	Diff Link	Changes
google provider	View Diff	3 files changed, 312 insertions(+)
google-beta provider	View Diff	3 files changed, 312 insertions(+)

Test report

Analytics

Total Tests	Passed	Skipped	Affected
30	28	2	0

Affected Service Packages

• oracledatabase

Learn how VCR tests work

---

Step 1: Replaying Mode

🟢 All tests passed in Replaying mode! No Recording was needed.

View the replaying VCR build log

@swethamagesh14, @BBBmau VCR tests complete for 9834d07!