From 531b4a2087306716af62b902e019e171cbf570aa Mon Sep 17 00:00:00 2001 From: fpagny Date: Thu, 26 Sep 2024 11:39:21 +0200 Subject: [PATCH 1/2] Update connection-errors.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add documentation on several unsupported features from Serverless SQL Database leading to errors when performed. --- .../troubleshooting/connection-errors.mdx | 57 ++++++++++++++++++- 1 file changed, 56 insertions(+), 1 deletion(-) diff --git a/serverless/sql-databases/troubleshooting/connection-errors.mdx b/serverless/sql-databases/troubleshooting/connection-errors.mdx index da3ad6708e..6473d52007 100644 --- a/serverless/sql-databases/troubleshooting/connection-errors.mdx +++ b/serverless/sql-databases/troubleshooting/connection-errors.mdx @@ -52,6 +52,61 @@ The [IAM principal](/identity-and-access-management/iam/concepts/#principal) (us - `ServerlessSQLDatabaseReadWrite` - `ServerlessSQLDatabaseFullAccess` +## ERROR: permission denied to create temporary tables/subscription in database + +### Problem + +The error messages below appear when trying to create `TEMPORARY TABLES` or `SUBSCRIPTION` in a Serverless SQL Database: + + ``` + ERROR: permission denied to create temporary tables in database + ERROR: permission denied to create subscription + ``` + +### Cause + +Serverless SQL Database [does not support yet `TEMPORARY TABLES` or `SUBSCRIPTION`.](https://www.scaleway.com/en/docs/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features) + +### Solution + +If you (or a third party tool you are using, especially `ETL` tools such as Airbyte, Fivetran or Meltano) require `TEMPORARY TABLES`, we suggest you use a [Managed Database for PostgreSQL](https://www.scaleway.com/en/database/). Note that `SUBSCRIPTION` are not yet supported by Managed Databases for PostgreSQL, but you can [import data with ETL tools through these steps](https://www.scaleway.com/en/docs/managed-databases/postgresql-and-mysql/api-cli/import-data-to-managed-postgresql-databases/#import-data-from-a-file-csv-txt-etc). + +## ERROR: prepared transactions are disabled + +### Problem + +The error message below appears when trying to use `PREPARE TRANSACTION` in a Serverless SQL Database: + + ``` + ERROR: prepared transactions are disabled + ``` + +### Cause + +Serverless SQL Database [does not support `PREPARE TRANSACTION`.](https://www.scaleway.com/en/docs/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features) + +### Solution + +If you require this feature, we suggest you use a [Managed Database for PostgreSQL](https://www.scaleway.com/en/database/). + +## ERROR: cannot refresh materialized view concurrently + +### Problem + +The error message below appears when trying to connect to the Serverless SQL Database: + + ``` + ERROR: cannot refresh materialized view "example-view" concurrently + ``` + +### Cause + +Serverless SQL Database [does not support `REFRESH MATERIALIZED VIEW CONCURRENTLY`.](https://www.scaleway.com/en/docs/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features). Note that `REFRESH MATERIALIZED VIEW` is supported, only `CONCURRENTLY` keyword is not supported. + +### Solution + +If you require this feature, we suggest you use a [Managed Database for PostgreSQL](https://www.scaleway.com/en/database/). + ## Database hostname was not sent to server ### Problem @@ -105,4 +160,4 @@ This error happens when the SQL client you are using does not support the TLS Se | N/A | IntelliJ (SQL Module) | Yes | | | N/A | navicat | No | | | N/A | Stitch | No | | -| N/A | Terraform | No | Terraform includes an older lib/pq version (v1.10.3) which does not support SNI. | \ No newline at end of file +| N/A | Terraform | No | Terraform includes an older lib/pq version (v1.10.3) which does not support SNI. | From af946333498238594e5482e7481622530d3c8651 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Fri, 27 Sep 2024 15:13:18 +0200 Subject: [PATCH 2/2] Apply suggestions from code review --- .../troubleshooting/connection-errors.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/serverless/sql-databases/troubleshooting/connection-errors.mdx b/serverless/sql-databases/troubleshooting/connection-errors.mdx index 6473d52007..c17a695418 100644 --- a/serverless/sql-databases/troubleshooting/connection-errors.mdx +++ b/serverless/sql-databases/troubleshooting/connection-errors.mdx @@ -65,11 +65,11 @@ The error messages below appear when trying to create `TEMPORARY TABLES` or `SUB ### Cause -Serverless SQL Database [does not support yet `TEMPORARY TABLES` or `SUBSCRIPTION`.](https://www.scaleway.com/en/docs/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features) +Serverless SQL Databases do not support `TEMPORARY TABLES` or `SUBSCRIPTION` yet. Refer to the [known differences](/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features) page for more information. ### Solution -If you (or a third party tool you are using, especially `ETL` tools such as Airbyte, Fivetran or Meltano) require `TEMPORARY TABLES`, we suggest you use a [Managed Database for PostgreSQL](https://www.scaleway.com/en/database/). Note that `SUBSCRIPTION` are not yet supported by Managed Databases for PostgreSQL, but you can [import data with ETL tools through these steps](https://www.scaleway.com/en/docs/managed-databases/postgresql-and-mysql/api-cli/import-data-to-managed-postgresql-databases/#import-data-from-a-file-csv-txt-etc). +If you (or a third party tool you are using, especially ETL tools such as Airbyte, Fivetran or Meltano) require `TEMPORARY TABLES`, we suggest you use a [Managed Database for PostgreSQL](https://www.scaleway.com/en/database/). `SUBSCRIPTION` is not supported by Managed Databases for PostgreSQL yet, but you can [import data with ETL tools](/managed-databases/postgresql-and-mysql/api-cli/import-data-to-managed-postgresql-databases/#import-data-from-a-file-csv-txt-etc). ## ERROR: prepared transactions are disabled @@ -83,11 +83,11 @@ The error message below appears when trying to use `PREPARE TRANSACTION` in a Se ### Cause -Serverless SQL Database [does not support `PREPARE TRANSACTION`.](https://www.scaleway.com/en/docs/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features) +Serverless SQL Databases do not support `PREPARE TRANSACTION`. Refer to the [dedicated documentation](/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features) for more information. ### Solution -If you require this feature, we suggest you use a [Managed Database for PostgreSQL](https://www.scaleway.com/en/database/). +If you require this feature, we suggest you use a [Managed Database for PostgreSQL](/managed-databases/postgresql-and-mysql/). ## ERROR: cannot refresh materialized view concurrently @@ -101,11 +101,11 @@ The error message below appears when trying to connect to the Serverless SQL Dat ### Cause -Serverless SQL Database [does not support `REFRESH MATERIALIZED VIEW CONCURRENTLY`.](https://www.scaleway.com/en/docs/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features). Note that `REFRESH MATERIALIZED VIEW` is supported, only `CONCURRENTLY` keyword is not supported. +Serverless SQL Databases do not support `REFRESH MATERIALIZED VIEW CONCURRENTLY`. However, the `REFRESH MATERIALIZED VIEW` command is supported, only the `CONCURRENTLY` keyword is not supported. Refer to the [dedicated documentation](/serverless/sql-databases/reference-content/known-differences/#unsupported-sql-features) for more information. ### Solution -If you require this feature, we suggest you use a [Managed Database for PostgreSQL](https://www.scaleway.com/en/database/). +If you require this feature, we suggest you use a [Managed Database for PostgreSQL](/managed-databases/postgresql-and-mysql/). ## Database hostname was not sent to server