diff --git a/website/docs/d/sql_database.html.markdown b/website/docs/d/sql_database.html.markdown
index 351f1155cf58d..48186a95ef07b 100644
--- a/website/docs/d/sql_database.html.markdown
+++ b/website/docs/d/sql_database.html.markdown
@@ -36,8 +36,8 @@ output "sql_database_id" {
* `id` - The SQL Database ID.
-* `collation` - The name of the collation.
-
+* `collation` - The name of the collation.
+
* `creation_date` - The creation date of the SQL Database.
* `default_secondary_location` - The default secondary location of the SQL Database.
@@ -51,17 +51,17 @@ output "sql_database_id" {
* `location` - The location of the Resource Group in which the SQL Server exists.
* `name` - The name of the database.
-
+
* `read_scale` - Indicate if read-only connections will be redirected to a high-available replica.
* `requested_service_objective_id` - The ID pertaining to the performance level of the database.
-
+
* `requested_service_objective_name` - The name pertaining to the performance level of the database.
* `resource_group_name` - The name of the resource group in which the database resides. This will always be the same resource group as the Database Server.
* `server_name` - The name of the SQL Server on which to create the database.
-
+
* `tags` - A mapping of tags assigned to the resource.
## Timeouts
diff --git a/website/docs/r/sql_database.html.markdown b/website/docs/r/sql_database.html.markdown
index 65df025cf9f90..2b914737b1e04 100644
--- a/website/docs/r/sql_database.html.markdown
+++ b/website/docs/r/sql_database.html.markdown
@@ -10,6 +10,8 @@ description: |-
Allows you to manage an Azure SQL Database
+~> **Note:** Deprecated! Please use [mssql_database](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/mssql_database) for all future Microsoft SQL Azure Database Server uses.
+
~> **NOTE:** The Database Extended Auditing Policy Can be set inline here as well as with the [mssql_database_extended_auditing_policy resource](mssql_database_extended_auditing_policy.html) resource. You can only use one or the other and using both will cause a conflict.
## Example Usage
@@ -61,6 +63,7 @@ resource "azurerm_sql_database" "example" {
}
}
```
+
## Argument Reference
The following arguments are supported:
@@ -89,7 +92,7 @@ The following arguments are supported:
* `requested_service_objective_id` - (Optional) A GUID/UUID corresponding to a configured Service Level Objective for the Azure SQL database which can be used to configure a performance level.
.
-* `requested_service_objective_name` - (Optional) The service objective name for the database. Valid values depend on edition and location and may include `S0`, `S1`, `S2`, `S3`, `P1`, `P2`, `P4`, `P6`, `P11` and `ElasticPool`. You can list the available names with the cli: ```shell az sql db list-editions -l westus -o table ```. For further information please see [Azure CLI - az sql db](https://docs.microsoft.com/en-us/cli/azure/sql/db?view=azure-cli-latest#az-sql-db-list-editions).
+* `requested_service_objective_name` - (Optional) The service objective name for the database. Valid values depend on edition and location and may include `S0`, `S1`, `S2`, `S3`, `P1`, `P2`, `P4`, `P6`, `P11` and `ElasticPool`. You can list the available names with the cli: `shell az sql db list-editions -l westus -o table`. For further information please see [Azure CLI - az sql db](https://docs.microsoft.com/en-us/cli/azure/sql/db?view=azure-cli-latest#az-sql-db-list-editions).
* `source_database_deletion_date` - (Optional) The deletion date time of the source database. Only applies to deleted databases where `create_mode` is `PointInTimeRestore`.
diff --git a/website/docs/r/sql_server.html.markdown b/website/docs/r/sql_server.html.markdown
index cb9d0de735c24..56c6188aa3b17 100644
--- a/website/docs/r/sql_server.html.markdown
+++ b/website/docs/r/sql_server.html.markdown
@@ -11,6 +11,8 @@ description: |-
Manages a Microsoft SQL Azure Database Server.
+~> **Note:** This resource provides usage of Microsoft SQL Azure Database server using an older `sku` based model. [It is recommended going forward](https://github.com/terraform-providers/terraform-provider-azurerm/issues/10217#issuecomment-762036693) to use [`azurerm_mssql_server`](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/mssql_server) resource which provides support for `vcores`.
+
~> **Note:** All arguments including the administrator login and password will be stored in the raw state as plain-text.
[Read more about sensitive data in state](/docs/state/sensitive-data.html).
@@ -50,6 +52,7 @@ resource "azurerm_sql_server" "example" {
}
}
```
+
## Argument Reference
The following arguments are supported: