Add examples to docs

Author: pietern

docs/resources/sql_dashboard.md

@@ -9,4 +9,30 @@ To manage [SQLA resources](https://docs.databricks.com/sql/get-started/concepts.
 
 **Note:** documentation for this resource is a work in progress.
 
-In the meantime, you can refer to the tests for this resource for usage examples.
+A dashboard may have one or more [widgets](sql_widget.md).
+
+## Example Usage
+
+```hcl
+resource "databricks_sql_dashboard" "d1" {
+  name = "My Dashboard Name"
+
+  tags = [
+    "some-tag",
+    "another-tag",
+  ]
+}
+```
+
+Example [permission](permissions.md) to share dashboard with all users:
+
+```hcl
+resource "databricks_permissions" "d1" {
+  sql_dashboard_id = databricks_sql_dashboard.d1.id
+
+  access_control {
+    group_name       = data.databricks_group.users.display_name
+    permission_level = "CAN_RUN"
+  }
+}
+```

docs/resources/sql_query.md

@@ -9,4 +9,46 @@ To manage [SQLA resources](https://docs.databricks.com/sql/get-started/concepts.
 
 **Note:** documentation for this resource is a work in progress.
 
-In the meantime, you can refer to the tests for this resource for usage examples.
+A query may have one or more [visualizations](sql_visualization.md).
+
+## Example Usage
+
+```hcl
+resource "databricks_sql_query" "q1" {
+  data_source_id = databricks_sql_endpoint.example.data_source_id
+  name = "My Query Name"
+  query = "SELECT {{ p1 }} AS p1, 2 as p2"
+
+  schedule {
+    continuous {
+      interval_seconds = 5 * 60
+    }
+  }
+
+  parameter {
+    name = "p1"
+    title = "Title for p1"
+    text {
+      value = "default"
+    }
+  }
+
+  tags = [
+    "t1",
+    "t2",
+  ]
+}
+```
+
+Example [permission](permissions.md) to share query with all users:
+
+```hcl
+resource "databricks_permissions" "q1" {
+  sql_query_id = databricks_sql_query.q1.id
+
+  access_control {
+    group_name       = data.databricks_group.users.display_name
+    permission_level = "CAN_RUN"
+  }
+}
+```

docs/resources/sql_visualization.md

@@ -9,4 +9,37 @@ To manage [SQLA resources](https://docs.databricks.com/sql/get-started/concepts.
 
 **Note:** documentation for this resource is a work in progress.
 
-In the meantime, you can refer to the tests for this resource for usage examples.
+A visualization is always tied to a [query](sql_query.md). Every query may have one or more visualizations.
+
+## Example Usage
+
+```hcl
+resource "databricks_sql_visualization" "q1v1" {
+  query_id = databricks_sql_query.q1.id
+  type = "table"
+  name = "My Table"
+  description = "Some Description"
+
+  // The options encoded in this field are passed verbatim to the SQLA API.
+  options = jsonencode(
+    {
+      "itemsPerPage" : 25,
+      "columns" : [
+        {
+          "name" : "p1",
+          "type" : "string"
+          "title" : "Parameter 1",
+          "displayAs" : "string",
+        },
+        {
+          "name" : "p2",
+          "type" : "string"
+          "title" : "Parameter 2",
+          "displayAs" : "link",
+          "highlightLinks" : true,
+        }
+      ]
+    }
+  )
+}
+```

docs/resources/sql_widget.md

@@ -9,4 +9,32 @@ To manage [SQLA resources](https://docs.databricks.com/sql/get-started/concepts.
 
 **Note:** documentation for this resource is a work in progress.
 
-In the meantime, you can refer to the tests for this resource for usage examples.
+A widget is always tied to a [dashboard](sql_dashboard.md). Every dashboard may have one or more widgets.
+
+## Example Usage
+
+```
+resource "databricks_sql_widget" "d1w1" {
+  dashboard_id = databricks_sql_dashboard.d1.id
+  text = "Hello! I'm a **text widget**!"
+
+  position {
+    size_x = 3
+    size_y = 4
+    pos_x = 0
+    pos_y = 0
+  }
+}
+
+resource "databricks_sql_widget" "d1w2" {
+  dashboard_id = databricks_sql_dashboard.d1.id
+  visualization_id = databricks_sql_visualization.q1v1.id
+
+  position {
+    size_x = 3
+    size_y = 4
+    pos_x = 3
+    pos_y = 0
+  }
+}
+```