Merge pull request #155 from dbt-labs/feature/identify-missing-resources

Feature - identify missing resources

Author: b-per

CHANGELOG.md

@@ -2,7 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
-## [Unreleased](https://github.com/dbt-labs/terraform-provider-dbtcloud/compare/v0.2.0...HEAD)
+## [Unreleased](https://github.com/dbt-labs/terraform-provider-dbtcloud/compare/v0.2.1...HEAD)
+
+## [0.2.1](https://github.com/dbt-labs/terraform-provider-dbtcloud/compare/v0.2.0...v0.2.1)
+
+## Changes
+
+- Resources deleted from dbt Cloud won't crash the provider and we now consider the resource as deleted, removing it from the state. This is the expected behaviour of a provider.
+- Add examples in the docs to resources that didn't have any so far
 
 ## [0.2.0](https://github.com/dbt-labs/terraform-provider-dbtcloud/compare/v0.1.12...v0.2.0)
 

VERSION

@@ -1 +1 @@
-0.2.0
+0.2.1

docs/resources/bigquery_credential.md

@@ -10,7 +10,18 @@ description: |-
 
 
 
-
+## Example Usage
+
+```terraform
+// use dbt_cloud_bigquery_credential instead of dbtcloud_bigquery_credential for the legacy resource names
+// legacy names will be removed from 0.3 onwards
+
+resource "dbtcloud_bigquery_credential" "test_credential" {
+  project_id  = dbtcloud_project.my_project.id
+  dataset     = "my_bq_dataset"
+  num_threads = 16
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/databricks_credential.md

@@ -10,7 +10,32 @@ description: |-
 
 
 
-
+## Example Usage
+
+```terraform
+// use dbt_cloud_databricks_credential instead of dbtcloud_databricks_credential for the legacy resource names
+// legacy names will be removed from 0.3 onwards
+
+# when using the Databricks adapter
+resource "dbtcloud_databricks_credential" "databricks_cred" {
+  project_id   = dbtcloud_project.my_project.id
+  adapter_id   = 123
+  target_name  = "prod"
+  token        = "abcdefgh"
+  schema       = "my_schema"
+  adapter_type = "databricks"
+}
+
+# when using the Spark adapter
+resource "dbtcloud_databricks_credential" "spark_cred" {
+  project_id   = dbtcloud_project.my_other_project.id
+  adapter_id   = 456
+  target_name  = "prod"
+  token        = "abcdefgh"
+  schema       = "my_schema"
+  adapter_type = "spark"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/group.md

@@ -16,16 +16,16 @@ description: |-
 // legacy names will be removed from 0.3 onwards
 
 resource "dbtcloud_group" "test_group" {
-    name = "Test Group"
-    group_permissions {
-        permission_set = "member"
-        all_projects = true
-    }
-    group_permissions {
-        permission_set = "developer"
-        all_projects = false
-        project_id = dbt_cloud_project.test_project.id
-    }
+  name = "Test Group"
+  group_permissions {
+    permission_set = "member"
+    all_projects   = true
+  }
+  group_permissions {
+    permission_set = "developer"
+    all_projects   = false
+    project_id     = dbt_cloud_project.test_project.id
+  }
 }
 ```
 

docs/resources/job.md

@@ -35,7 +35,7 @@ resource "dbtcloud_job" "test" {
     "schedule" : false
   }
   # this is the default that gets set up when modifying jobs in the UI
-  schedule_days = [0,1,2,3,4,5,6]
+  schedule_days = [0, 1, 2, 3, 4, 5, 6]
   schedule_type = "days_of_week"
 }
 ```

docs/resources/postgres_credential.md

@@ -10,7 +10,22 @@ description: |-
 
 
 
-
+## Example Usage
+
+```terraform
+// use dbt_cloud_postgres_credential instead of dbtcloud_postgres_credential for the legacy resource names
+// legacy names will be removed from 0.3 onwards
+
+resource "dbtcloud_postgres_credential" "test_credential" {
+  is_active      = true
+  project_id     = dbt_cloud_project.test_project.id
+  type           = "postgres"
+  default_schema = "my_schema"
+  username       = "my_username"
+  password       = "my_password"
+  num_threads    = 16
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/project.md

@@ -10,7 +10,21 @@ description: |-
 
 
 
+## Example Usage
 
+```terraform
+// use dbt_cloud_project instead of dbtcloud_project for the legacy resource names
+// legacy names will be removed from 0.3 onwards
+
+resource "dbtcloud_project" "my_project" {
+  name = "Analytics"
+}
+
+resource "dbtcloud_project" "my_project_with_subdir" {
+  name                     = "Analytics in Subdir"
+  dbt_project_subdirectory = "/path"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/project_artefacts.md

@@ -10,7 +10,18 @@ description: |-
 
 
 
-
+## Example Usage
+
+```terraform
+// use dbt_cloud_project_artefacts instead of dbtcloud_project_artefacts for the legacy resource names
+// legacy names will be removed from 0.3 onwards
+
+resource "dbtcloud_project_artefacts" "my_project_artefacts" {
+  project_id       = dbtcloud_project.my_project.id
+  docs_job_id      = dbtcloud_job.my_job.id
+  freshness_job_id = dbtcloud_job.my_job.id
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/project_connection.md

@@ -10,7 +10,17 @@ description: |-
 
 
 
+## Example Usage
 
+```terraform
+// use dbt_cloud_project_connection instead of dbtcloud_project_connection for the legacy resource names
+// legacy names will be removed from 0.3 onwards
+
+resource "dbtcloud_project_connection" "my_project_connection" {
+  project_id    = dbtcloud_project.my_project.id
+  connection_id = dbtcloud_connection.my_connection.connection_id
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema