Skip to content

Commit 97726b9

Browse files
committed
Added the missing step for SAMI and fixed Acrolinx issues
1 parent 9d71d42 commit 97726b9

File tree

2 files changed

+17
-9
lines changed

2 files changed

+17
-9
lines changed

articles/data-factory/connector-azure-database-for-postgresql.md

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.date: 04/08/2025
1717
This article outlines how to use Copy Activity in Azure Data Factory and Synapse Analytics pipelines to copy data from and to Azure Database for PostgreSQL, and use Data Flow to transform data in Azure Database for PostgreSQL. To learn more, read the introductory articles for [Azure Data Factory](introduction.md) and [Synapse Analytics](../synapse-analytics/overview-what-is.md).
1818

1919
> [!IMPORTANT]
20-
> The Azure Database for PostgreSQL version 2.0 provides improved native Azure Database for PostgreSQL support. If you are using the Azure Database for PostgreSQL version 1.0 in your solution, you are recommended to [upgrade your Azure Database for PostgreSQL connector](#upgrade-the-azure-database-for-postgresql-connector) at your earliest convenience.
20+
> The Azure Database for PostgreSQL version 2.0 provides improved native Azure Database for PostgreSQL support. If you're using the Azure Database for PostgreSQL version 1.0 in your solution, you're recommended to [upgrade your Azure Database for PostgreSQL connector](#upgrade-the-azure-database-for-postgresql-connector) at your earliest convenience.
2121
2222
This connector is specialized for the [Azure Database for PostgreSQL service](/azure/postgresql/overview). To copy data from a generic PostgreSQL database located on-premises or in the cloud, use the [PostgreSQL connector](connector-postgresql.md).
2323

@@ -33,7 +33,7 @@ This Azure Database for PostgreSQL connector is supported for the following capa
3333

3434
*① Azure integration runtime ② Self-hosted integration runtime*
3535

36-
The three activities work on Azure Database for PostgreSQL [Single Server](/azure/postgresql/single-server/) and [Flexible Server](/azure/postgresql/flexible-server/), as well as [Azure Cosmos DB for PostgreSQL](/azure/postgresql/hyperscale/).
36+
The three activities work on Azure Database for PostgreSQL [Single Server](/azure/postgresql/single-server/) and [Flexible Server](/azure/postgresql/flexible-server/), and [Azure Cosmos DB for PostgreSQL](/azure/postgresql/hyperscale/).
3737

3838
> [!IMPORTANT]
3939
> Azure Database for PostgreSQL Single Server will be retired on March 28, 2025. Please migrate to Flexible Server by that date. You can refer to this [article](/azure/postgresql/migrate/migration-service/overview-migration-service-postgresql) and [FAQ](/azure/postgresql/migrate/whats-happening-to-postgresql-single-server) for the migration guidance.
@@ -46,7 +46,7 @@ The three activities work on Azure Database for PostgreSQL [Single Server](/azu
4646

4747
Use the following steps to create a linked service to Azure database for PostgreSQL in the Azure portal UI.
4848

49-
1. Browse to the Manage tab in your Azure Data Factory or Synapse workspace and select Linked Services, then click New:
49+
1. Browse to the Manage tab in your Azure Data Factory or Synapse workspace and select Linked Services, then select New:
5050

5151
# [Azure Data Factory](#tab/data-factory)
5252

@@ -87,7 +87,7 @@ The following properties are supported for the Azure Database for PostgreSQL lin
8787
| server | Specifies the host name and optionally port on which Azure Database for PostgreSQL is running. | Yes |
8888
| port |The TCP port of the Azure Database for PostgreSQL server. The default value is `5432`. |No |
8989
| database| The name of the Azure Database for PostgreSQL database to connect to. |Yes |
90-
| sslMode | Controls whether SSL is used, depending on server support. <br/>- **Disable**: SSL is disabled. If the server requires SSL, the connection will fail.<br/>- **Allow**: Prefer non-SSL connections if the server allows them, but allow SSL connections.<br/>- **Prefer**: Prefer SSL connections if the server allows them, but allow connections without SSL.<br/>- **Require**: The connection fails if the server doesn't support SSL.<br/>- **Verify-ca**: The connection fails if the server doesn't support SSL. Also verifies server certificate.<br/>- **Verify-full**: The connection fails if the server doesn't support SSL. Also verifies server certificate with host's name. <br/>Options: Disable (0) / Allow (1) / Prefer (2) **(Default)** / Require (3) / Verify-ca (4) / Verify-full (5) | No |
90+
| sslMode | Controls whether SSL is used, depending on server support. <br/>- **Disable**: SSL is disabled. If the server requires SSL, the connection fails.<br/>- **Allow**: Prefer non-SSL connections if the server allows them, but allow SSL connections.<br/>- **Prefer**: Prefer SSL connections if the server allows them, but allow connections without SSL.<br/>- **Require**: The connection fails if the server doesn't support SSL.<br/>- **Verify-ca**: The connection fails if the server doesn't support SSL. Also verifies server certificate.<br/>- **Verify-full**: The connection fails if the server doesn't support SSL. Also verifies server certificate with host's name. <br/>Options: Disable (0) / Allow (1) / Prefer (2) **(Default)** / Require (3) / Verify-ca (4) / Verify-full (5) | No |
9191
| connectVia | This property represents the [integration runtime](concepts-integration-runtime.md) to be used to connect to the data store. You can use Azure Integration Runtime or Self-hosted Integration Runtime (if your data store is located in private network). If not specified, it uses the default Azure Integration Runtime.|No|
9292
| ***Additional connection properties:*** | | |
9393
| schema | Sets the schema search path. | No |
@@ -97,7 +97,7 @@ The following properties are supported for the Azure Database for PostgreSQL lin
9797
| trustServerCertificate | Whether to trust the server certificate without validating it. | No |
9898
| readBufferSize | Determines the size of the internal buffer Npgsql uses when reading. Increasing may improve performance if transferring large values from the database. | No |
9999
| timezone | Gets or sets the session timezone. | No |
100-
| encoding | Gets or sets the .NET encoding that will be used to encode/decode PostgreSQL string data. | No |
100+
| encoding | Gets or sets the .NET encoding for encoding/decoding PostgreSQL string data. | No |
101101

102102
### Basic authentication
103103

@@ -167,7 +167,15 @@ To use System-assigned managed identity, follow the steps:
167167

168168
1. The Azure data for PostgreSQL with System assigned managed identity **On**.
169169

170-
:::image type="content" source="media/connector-azure-database-for-postgresql/system-managed-identity-configuration.png" alt-text="Screenshot of the system assigned managed identity configuration in the Azure database for PostgreSQL server resource." lightbox="media/connector-azure-database-for-postgresql/system-managed-identity-configuration.png":::
170+
:::image type="content" source="media/connector-azure-database-for-postgresql/system-managed-identity-configuration.png" alt-text="Screenshot of the system assigned managed identity configuration in the Azure database for PostgreSQL server." lightbox="media/connector-azure-database-for-postgresql/system-managed-identity-configuration.png":::
171+
172+
1. In your Azure Database for PostgreSQL resource under **Security**
173+
1. Select **Authentication**
174+
1. Select either **Microsoft Entra authentication only** or **PostgreSQL and Microsoft Entra authentication** Authentication method.
175+
1. Select **+ Add Microsoft Entra administrators**
176+
1. Add the system-assigned managed identity for the Azure Data Factory resource as one of the **Microsoft Entra Administrators**
177+
178+
:::image type="content" source="media/connector-azure-database-for-postgresql/system-assigned-managed-identity-adding-access.png" alt-text="Screenshot of adding system assigned managed identity in the Azure Database for PostgreSQL configuration." lightbox="media/connector-azure-database-for-postgresql/system-assigned-managed-identity-adding-access.png":::
171179

172180
1. Configure an Azure database for PostgreSQL linked service.
173181

@@ -208,13 +216,13 @@ You also need to follow the steps:
208216
1. In your Azure database for PostgreSQL server resource, under **Security**
209217
1. Select **Authentication**
210218
1. Verify if Authentication method is **Microsoft Entra authentication only** or **PostgreSQL and Microsoft Entra authentication**
211-
1. Click on **+ Add Microsoft Entra administrators** and select your user-assigned managed identity
219+
1. Select **+ Add Microsoft Entra administrators** link and select your user-assigned managed identity
212220

213221
:::image type="content" source="media/connector-azure-database-for-postgresql/user-managed-identity-postgresql-configuration.png" alt-text="Screenshot of the user-assigned managed identity configuration in the Azure database for PostgreSQL server." lightbox="media/connector-azure-database-for-postgresql/user-managed-identity-postgresql-configuration.png":::
214222

215223
1. Assign the **User-assigned Managed Identity** to your Azure Data Factory resource
216224
1. Select **Settings** and then **Managed Identities**
217-
1. Under the **User assigned** tab. Click on the **+ Add** and select your user-managed identity
225+
1. Under the **User assigned** tab. Select the **+ Add** link and select your user-managed identity
218226

219227
:::image type="content" source="media/connector-azure-database-for-postgresql/data-factory-user-identity-configuration.png" alt-text="Screenshot of the user-assigned managed identity configuration in the Azure Data Factory resource." lightbox="media/connector-azure-database-for-postgresql/data-factory-user-identity-configuration.png":::
220228

@@ -255,7 +263,7 @@ Example:
255263
| servicePrincipalKey | Client secret value. Used when service principal key is selected | Yes |
256264
| azureCloudType | Select the Azure cloud type of your Azure Database for PostgreSQL server | Yes |
257265
| servicePrincipalEmbeddedCert | Service principal certificate file | Yes |
258-
| servicePrincipalEmbeddedCertPassword | Service principal certificate password if required | No |
266+
| servicePrincipalEmbeddedCertPassword | Service principal certificate password if necessary | No |
259267

260268
**Example**:
261269

Loading

0 commit comments

Comments
 (0)