Интеграция Базы данных Azure для PostgreSQL с помощью соединителя сервисов

На этой странице показаны поддерживаемые методы проверки подлинности и клиенты, а также показан пример кода, который можно использовать для подключения База данных Azure для PostgreSQL к другим облачным службам с помощью соединителя служб. Вы по-прежнему можете подключаться к Базе данных Azure для PostgreSQL, используя другие языки программирования без помощи соединителя сервисов. На этой странице также показаны имена и значения переменных среды по умолчанию (или конфигурация Spring Boot), которые вы получаете при создании подключения к службе.

Поддерживаемые службы вычислений

Соединитель служб можно использовать для подключения следующих вычислительных служб к База данных Azure для PostgreSQL:

• Служба приложений Azure
• Функции Azure
• Настройка приложения Azure
• Azure Spring Apps

Поддерживаемые типы проверки подлинности и типы клиентов

В таблице ниже показано, какие сочетания методов проверки подлинности и клиентов поддерживаются для подключения вычислительной службы к База данных Azure для PostgreSQL с помощью соединителя служб. Значение "Да" указывает, что сочетание поддерживается, а значение "Нет" указывает, что оно не поддерживается.

Тип клиента	Управляемое удостоверение, назначаемое системой	Управляемое удостоверение, назначаемое пользователем	Секрет/строка подключения	Субъект-служба
.NET	Да	Да	Да	Да
Go (pg)	Да	Да	Да	Да
Java (JDBC)	Да	Да	Да	Да
Java — Spring Boot (JDBC)	Да	Да	Да	Да
Node.js (pg)	Да	Да	Да	Да
PHP (нативный)	Да	Да	Да	Да
Python (psycopg2)	Да	Да	Да	Да
Python-Django	Да	Да	Да	Да
Ruby (ruby-pg)	Да	Да	Да	Да
Не допускается	Да	Да	Да	Да

Эта таблица указывает, что поддерживаются все сочетания типов клиентов и методов проверки подлинности в таблице. Все типы клиентов могут использовать любой из методов проверки подлинности для подключения к База данных Azure для PostgreSQL с помощью соединителя службы.

Примечание.

Назначаемое системой управляемое удостоверение, назначаемое пользователем управляемое удостоверение и субъект-служба, поддерживаются только в Azure CLI.

Имена переменных среды по умолчанию или свойства приложения и пример кода

Ссылайтесь на сведения о подключении и пример кода в следующих таблицах в соответствии с типом проверки подлинности подключения и типом клиента, чтобы подключить вычислительные службы к База данных Azure для PostgreSQL. Дополнительные сведения о соглашениях об именовании см. во внутренней статье соединителя служб.

Управляемое удостоверение, назначаемое системой

.NET

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения .NET PostgreSQL	Server=<PostgreSQL-server-name>.postgres.database.azure.com;Database=<database-name>;Port=5432;Ssl Mode=Require;User Id=<username>;

Java

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения PostgreSQL для JDBC	jdbc:postgresql://<PostgreSQL-server-name>.postgres.database.azure.com:5432/<database-name>?sslmode=require&user=<username>

SpringBoot

Свойства приложения	Description	Пример значения
spring.datasource.azure.passwordless-enabled	Включение проверки подлинности без пароля	true
spring.datasource.url	URL-адрес базы данных	jdbc:postgresql://<PostgreSQL-server-name>.postgres.database.azure.com:5432/<database-name>?sslmode=require
spring.datasource.username	Имя пользователя базы данных	username

Python

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения для psycopg2	dbname=<database-name> host=<PostgreSQL-server-name>.postgres.database.azure.com port=5432 sslmode=require user=<username>

Django

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_NAME	Имя базы данных	<database-name>
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USER	Имя пользователя базы данных	<username>

Go

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Go PostgreSQL строка подключения	host=<PostgreSQL-server-name>.postgres.database.azure.com dbname=<database-name> sslmode=require user=<username>

NodeJS

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USER	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_DATABASE	Имя базы данных	<database-name>
AZURE_POSTGRESQL_PORT	Номер порта	5432
AZURE_POSTGRESQL_SSL	Параметр SSL	true

PHP

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения PHP на собственном языке PostgreSQL	host=<PostgreSQL-server-name>.postgres.database.azure.com port=5432 dbname=<database-name> sslmode=require user=<username>

Ruby

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Ruby PostgreSQL строка подключения	host=<your-postgres-server-name>.postgres.database.azure.com port=5432 dbname=<database-name> sslmode=require user=<username>

Другое

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USERNAME	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_DATABASE	Имя базы данных	<database-name>
AZURE_POSTGRESQL_PORT	Номер порта	5432
AZURE_POSTGRESQL_SSL	Параметр SSL	true

Пример кода

Ознакомьтесь с инструкциями и кодом ниже, чтобы подключиться к База данных Azure для PostgreSQL с помощью управляемого удостоверения, назначаемого системой.

.NET

Для .NET нет подключаемого модуля или библиотеки для поддержки подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить с помощью клиентской библиотеки, такой как Azure.Identity. Затем вы можете использовать маркер доступа в качестве пароля для подключения к базе данных. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

using Azure.Identity;
using Azure.Core;
using Npgsql;

// Uncomment the following lines corresponding to the authentication type you want to use.
// For system-assigned identity.
// var sqlServerTokenProvider = new DefaultAzureCredential();

// For user-assigned identity.
// var sqlServerTokenProvider = new DefaultAzureCredential(
//     new DefaultAzureCredentialOptions
//     {
//         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTID");
//     }
// );

// For service principal.
// var tenantId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTSECRET");
// var sqlServerTokenProvider = new ClientSecretCredential(tenantId, clientId, clientSecret);

// Acquire the access token. 
AccessToken accessToken = await sqlServerTokenProvider.GetTokenAsync(
    new TokenRequestContext(scopes: new string[]
    {
        "https://ossrdbms-aad.database.windows.net/.default"
    }));

// Combine the token with the connection string from the environment variables provided by Service Connector.
string connectionString =
    $"{Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CONNECTIONSTRING")};Password={accessToken.Token}";

// Establish the connection.
using (var connection = new NpgsqlConnection(connectionString))
{
    Console.WriteLine("Opening connection using access token...");
    connection.Open();
}

Java

1. Добавьте следующие зависимости в файл pom.xml :

   <dependency>
       <groupId>org.postgresql</groupId>
       <artifactId>postgresql</artifactId>
       <version>42.3.6</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity-extensions</artifactId>
       <version>1.1.5</version>
   </dependency>
   

2. Получите строка подключения из переменных среды и добавьте имя подключаемого модуля для подключения к базе данных:

   import java.sql.*;
   
   String url = System.getenv("AZURE_POSTGRESQL_CONNECTIONSTRING");
   String pluginName = "com.Azure.identity.extensions.jdbc.postgresql.AzurePostgresqlAuthenticationPlugin";  
   Connection connection = DriverManager.getConnection(url + "&authenticationPluginClassName=" + pluginName);
   

Дополнительные сведения см. на следующих ресурсах:

• Руководство. Подключение к Postgre База данных SQL из приложения контейнера Java Quarkus без секретов с помощью управляемого удостоверения
• Руководство. Подключение к Postgre База данных SQL из Java Tomcat Служба приложений без секретов с помощью управляемого удостоверения
• Краткое руководство. Использование Java и JDBC с гибким сервером База данных Azure для PostgreSQL
• Перенос приложения на использование бессерверных подключений с База данных Azure для PostgreSQL

SpringBoot

Если вы создаете подключение с параметром --client-type springbootSpring, соединитель службы задает свойства spring.datasource.azure.passwordless-enabledspring.datasource.urlи spring.datasource.username Azure Spring Apps.

Обновите приложение после учебника Привязка База данных Azure для PostgreSQL к приложению в Azure Spring Apps. Не забудьте удалить spring.datasource.password свойство конфигурации, если оно было задано ранее и добавить правильные зависимости в приложение Spring.

Дополнительные руководства см. в статье Использование Spring Data JDBC с База данных Azure для PostgreSQL и учебниками. Развертывание приложения Spring в Azure Spring Apps с помощью без пароля подключения к базе данных Azure.

Python

1. Установите зависимости.

   pip install azure-identity
   pip install psycopg2-binary
   pip freeze > requirements.txt # Save the dependencies to a file
   

2. Получение маркера доступа с помощью azure-identity библиотеки и использование маркера в качестве пароля. Получение сведений о подключении из переменных среды, добавленных соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   from azure.identity import DefaultAzureCredential
   import psycopg2
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # cred = DefaultAzureCredential()
   
   # For user-assigned identity.
   # managed_identity_client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)   
   
   # For service principal.
   # tenant_id = os.getenv('AZURE_POSTGRESQL_TENANTID')
   # client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # client_secret = os.getenv('AZURE_POSTGRESQL_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   # Acquire the access token
   accessToken = cred.get_token('https://ossrdbms-aad.database.windows.net/.default')
   
   # Combine the token with the connection string from the environment variables added by Service Connector to establish the connection.
   conn_string = os.getenv('AZURE_POSTGRESQL_CONNECTIONSTRING')
   conn = psycopg2.connect(conn_string + ' password=' + accessToken.token) 
   

Django

1. Установите зависимости.

   pip install azure-identity
   

2. Получение маркера доступа с помощью библиотеки с помощью azure-identity переменных среды, добавленных соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   from azure.identity import DefaultAzureCredential
   import psycopg2
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # credential = DefaultAzureCredential()
   
   # For user-assigned identity.
   # managed_identity_client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)    
   
   # For service principal.
   # tenant_id = os.getenv('AZURE_POSTGRESQL_TENANTID')
   # client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # client_secret = os.getenv('AZURE_POSTGRESQL_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   # Acquire the access token.
   accessToken = cred.get_token('https://ossrdbms-aad.database.windows.net/.default')
   

3. В файле параметров получите сведения о базе данных Azure PostgreSQL из переменных среды, добавленных службой Service Connector. Используйте accessToken полученный на предыдущем шаге для доступа к базе данных.

   # In your setting file, eg. settings.py
   host = os.getenv('AZURE_POSTGRESQL_HOST')
   user = os.getenv('AZURE_POSTGRESQL_USER')
   password = accessToken.token # this is accessToken acquired from above step.
   database = os.getenv('AZURE_POSTGRESQL_NAME')
   
   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql_psycopg2',
           'NAME': database,
           'USER': user,
           'PASSWORD': password,
           'HOST': host,
           'PORT': '5432',  # Port is 5432 by default 
           'OPTIONS': {'sslmode': 'require'},
       }
   }
   

Go

1. Установите зависимости.

   go get github.com/lib/pq
   go get "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   go get "github.com/Azure/azure-sdk-for-go/sdk/azcore"
   

2. В коде получите маркер доступа с помощью azidentity, а затем используйте его в качестве пароля для подключения к Azure PostgreSQL, а также сведения о подключении, предоставляемые соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   import (
   "database/sql"
   "fmt"
   "os"
   
   "context"
   
   "github.com/Azure/azure-sdk-for-go/sdk/azcore/policy"
   "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   
    _ "github.com/lib/pq"
   )    
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // For system-assigned identity.
   // cred, err := azidentity.NewDefaultAzureCredential(nil)
   
   // For user-assigned identity.
   // clientid := os.Getenv("AZURE_POSTGRESQL_CLIENTID")
   // azidentity.ManagedIdentityCredentialOptions.ID := clientid
   // options := &azidentity.ManagedIdentityCredentialOptions{ID: clientid}
   // cred, err := azidentity.NewManagedIdentityCredential(options)
   
   // For service principal.
   // clientid := os.Getenv("AZURE_POSTGRESQL_CLIENTID")
   // tenantid := os.Getenv("AZURE_POSTGRESQL_TENANTID")
   // clientsecret := os.Getenv("AZURE_POSTGRESQL_CLIENTSECRET")
   // cred, err := azidentity.NewClientSecretCredential(tenantid, clientid, clientsecret, &azidentity.ClientSecretCredentialOptions{})
   
   if err != nil {
       // error handling
   }
   
   // Acquire the access token
   ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
   token, err := cred.GetToken(ctx, policy.TokenRequestOptions{
       Scopes: []string("https://ossrdbms-aad.database.windows.net/.default"),
   })
   
   // Combine the token with the connection string from the environment variables added by Service Connector to establish the connection.
   connectionString := os.Getenv("AZURE_POSTGRESQL_CONNECTIONSTRING") + " password=" + token.Token
   
   conn, err := sql.Open("postgres", connectionString)
    if err != nil {
    	panic(err)
    }
   
    conn.Close()
   

NodeJS

1. Установите зависимости.

   npm install --save @azure/identity
   npm install --save pg
   

2. В коде получите маркер доступа с помощью @azure/identity и сведения о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Объедините их для установления соединения. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   import { DefaultAzureCredential, ClientSecretCredential } from "@azure/identity";
   const { Client } = require('pg');
   
   // Uncomment the following lines corresponding to the authentication type you want to use.  
   // For system-assigned identity.
   // const credential = new DefaultAzureCredential();
   
   // For user-assigned identity.
   // const clientId = process.env.AZURE_POSTGRESQL_CLIENTID;
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: clientId
   // });
   
   // For service principal.
   // const tenantId = process.env.AZURE_POSTGRESQL_TENANTID;
   // const clientId = process.env.AZURE_POSTGRESQL_CLIENTID;
   // const clientSecret = process.env.AZURE_POSTGRESQL_CLIENTSECRET;
   
   // Acquire the access token.
   var accessToken = await credential.getToken('https://ossrdbms-aad.database.windows.net/.default');
   
   // Use the token and the connection information from the environment variables added by Service Connector to establish the connection.
   (async () => {
   const client = new Client({
       host: process.env.AZURE_POSTGRESQL_HOST,
       user: process.env.AZURE_POSTGRESQL_USER,
       password: accesstoken.token,
       database: process.env.AZURE_POSTGRESQL_DATABASE,
       port: Number(process.env.AZURE_POSTGRESQL_PORT) ,
       ssl: process.env.AZURE_POSTGRESQL_SSL
   });
   await client.connect();
   
   await client.end();
   })();
   

PHP

Для PHP нет подключаемого модуля или библиотеки для подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить и использовать в качестве пароля для подключения к базе данных. Маркер доступа можно получить с помощью REST API Azure.

1. В коде получите маркер доступа с помощью REST API с любимой библиотекой.

   Для назначаемых пользователем удостоверений и назначаемых системой удостоверений Служба приложений и контейнерных приложений предоставляет внутреннюю конечную точку REST для получения маркеров для управляемых удостоверений путем определения двух переменных среды: IDENTITY_ENDPOINT и IDENTITY_HEADER. Дополнительные сведения см . в справочнике по конечной точке REST. Получите маркер доступа, выполнив HTTP-запрос GET к конечной точке удостоверения и используя https://ossrdbms-aad.database.windows.net его как resource в запросе. Для удостоверения, назначаемого пользователем, добавьте идентификатор клиента из переменных среды, добавленных соединителем службы в запрос, а также.

   Сведения о том, как получить маркер доступа, см. в запросе маркера доступа между службами Azure AD. Сделайте запрос POST областью https://ossrdbms-aad.database.windows.net/.default действия и с идентификатором клиента, идентификатором клиента и секретом клиента субъекта-службы из переменных среды, добавленных соединителем службы.

2. Объедините маркер доступа и sting подключения PostgreSQL из переменных среды, добавленных службой Соединителя служб для установления подключения.

   <?php
   $conn_string = sprintf("%s password=", getenv('AZURE_POSTGRESQL_CONNECTIONSTRING'), $access_token);
   $dbconn = pg_connect($conn_string);
   ?>
   

Ruby

Для Ruby нет подключаемого модуля или библиотеки для подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить и использовать в качестве пароля для подключения к базе данных. Маркер доступа можно получить с помощью REST API Azure.

1. Установите зависимости.

   gem install pg
   

2. В коде получите маркер доступа с помощью REST API и сведений о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Объедините их для установления соединения. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   Служба приложений и приложения-контейнеры предоставляют внутреннюю конечную точку REST для получения маркеров для управляемых удостоверений. Дополнительные сведения см . в справочнике по конечной точке REST.

   require 'pg'
   require 'dotenv/load'
   require 'net/http'
   require 'json'
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # uri = URI(ENV['IDENTITY_ENDPOINT'] + '?resource=https://ossrdbms-aad.database.windows.net&api-version=2019-08-01')
   # res = Net::HTTP.get_response(uri, {'X-IDENTITY-HEADER' => ENV['IDENTITY_HEADER'], 'Metadata' => 'true'})  
   
   # For user-assigned identity.
   # uri = URI(ENV[IDENTITY_ENDPOINT] + '?resource=https://ossrdbms-aad.database.windows.net&api-version=2019-08-01&client-id=' + ENV['AZURE_POSTGRESQL_CLIENTID'])
   # res = Net::HTTP.get_response(uri, {'X-IDENTITY-HEADER' => ENV['IDENTITY_HEADER'], 'Metadata' => 'true'})  
   
   # For service principal
   # uri = URI('https://login.microsoftonline.com/' + ENV['AZURE_POSTGRESQL_TENANTID'] + '/oauth2/v2.0/token')
   # params = {
   #     :grant_type => 'client_credentials',
   #     :client_id: => ENV['AZURE_POSTGRESQL_CLIENTID'],
   #     :client_secret => ENV['AZURE_POSTGRESQL_CLIENTSECRET'],
   #     :scope => 'https://ossrdbms-aad.database.windows.net/.default'
   # }
   # req = Net::HTTP::POST.new(uri)
   # req.set_form_data(params)
   # req['Content-Type'] = 'application/x-www-form-urlencoded'
   # res = Net::HTTP.start(uri.hostname, uri.port, :use_ssl => true) do |http|
   #   http.request(req)
   
   parsed = JSON.parse(res.body)
   access_token = parsed["access_token"]
   
   # Use the token and the connection string from the environment variables added by Service Connector to establish the connection.
   conn = PG::Connection.new(
       connection_string: ENV['AZURE_POSTGRESQL_CONNECTIONSTRING'] + " password="  + access_token,
   )
   

   Дополнительные сведения о получении маркера доступа для субъекта-службы см. в запросе маркера доступа к службе Azure AD.

Другое

Для других языков используйте свойства подключения, которые соединитель службы задает переменным среды для подключения к базе данных. Сведения об переменной среды см. в разделе "Интеграция База данных Azure для PostgreSQL с соединителем службы".

Затем, если вы создали таблицы и последовательности в гибком сервере PostgreSQL перед использованием соединителя служб, необходимо подключиться как владелец и предоставить разрешение, созданное <aad-username> соединителем службы. Имя пользователя из строка подключения или конфигурации, заданное соединителем службы, должно выглядеть следующим образомaad_<connection name>. Если вы используете портал Azure, нажмите кнопку развертывания рядом с столбцом Service Type и получите значение. Если вы используете Azure CLI, проверьте configurations выходные данные команды CLI.

Затем выполните запрос, чтобы предоставить разрешение

az extension add --name rdbms-connect

az postgres flexible-server execute -n <postgres-name> -u <owner-username> -p "<owner-password>" -d <database-name> --querytext "GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO \"<aad-username>\";GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO \"<aad username>\";"

И <owner-username> <owner-password> является владельцем существующей таблицы, которая может предоставлять разрешения другим пользователям. <aad-username> — это пользователь, созданный с помощью соединителя службы. Замените их фактическим значением.

Проверьте результат с помощью команды:

az postgres flexible-server execute -n <postgres-name> -u <owner-username> -p "<owner-password>" -d <database-name> --querytext "SELECT distinct(table_name) FROM information_schema.table_privileges WHERE grantee='<aad-username>' AND table_schema='public';" --output table

Управляемое удостоверение, назначаемое пользователем

.NET

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения .NET PostgreSQL	Server=<PostgreSQL-server-name>.postgres.database.azure.com;Database=<database-name>;Port=5432;Ssl Mode=Require;User Id=<username>;

Java

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения PostgreSQL для JDBC	jdbc:postgresql://<PostgreSQL-server-name>.postgres.database.azure.com:5432/<database-name>?sslmode=require&user=<username>

SpringBoot

Свойства приложения	Description	Пример значения
spring.datasource.azure.passwordless-enabled	Включение проверки подлинности без пароля	true
spring.cloud.azure.credential.client-id	Идентификатор клиента	<identity-client-ID>
spring.cloud.azure.credential.client-managed-identity-enabled	Включение управляемого удостоверения клиента	true
spring.datasource.url	URL-адрес базы данных	jdbc:postgresql://<PostgreSQL-server-name>.postgres.database.azure.com:5432/<database-name>?sslmode=require
spring.datasource.username	Имя пользователя базы данных	username

Python

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения для psycopg2	dbname=<database-name> host=<PostgreSQL-server-name>.postgres.database.azure.com port=5432 sslmode=require user=<username>

Django

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_NAME	Имя базы данных	<database-name>
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USER	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<<identity-client-ID>>

Go

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Go PostgreSQL строка подключения	host=<PostgreSQL-server-name>.postgres.database.azure.com dbname=<database-name> sslmode=require user=<username>

NodeJS

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USER	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_DATABASE	Имя базы данных	<database-name>
AZURE_POSTGRESQL_PORT	Номер порта	5432
AZURE_POSTGRESQL_SSL	Параметр SSL	true
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>

PHP

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения PHP на собственном языке PostgreSQL	host=<PostgreSQL-server-name>.postgres.database.azure.com port=5432 dbname=<database-name> sslmode=require user=<username>

Ruby

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Ruby PostgreSQL строка подключения	host=<your-postgres-server-name>.postgres.database.azure.com port=5432 dbname=<database-name> sslmode=require user=<username>

Другое

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USERNAME	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_DATABASE	Имя базы данных	<database-name>
AZURE_POSTGRESQL_PORT	Номер порта	5432
AZURE_POSTGRESQL_SSL	Параметр SSL	true
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>

Пример кода

Ознакомьтесь с инструкциями и кодом ниже, чтобы подключиться к База данных Azure для PostgreSQL с помощью управляемого удостоверения, назначаемого пользователем.

.NET

Для .NET нет подключаемого модуля или библиотеки для поддержки подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить с помощью клиентской библиотеки, такой как Azure.Identity. Затем вы можете использовать маркер доступа в качестве пароля для подключения к базе данных. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

using Azure.Identity;
using Azure.Core;
using Npgsql;

// Uncomment the following lines corresponding to the authentication type you want to use.
// For system-assigned identity.
// var sqlServerTokenProvider = new DefaultAzureCredential();

// For user-assigned identity.
// var sqlServerTokenProvider = new DefaultAzureCredential(
//     new DefaultAzureCredentialOptions
//     {
//         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTID");
//     }
// );

// For service principal.
// var tenantId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTSECRET");
// var sqlServerTokenProvider = new ClientSecretCredential(tenantId, clientId, clientSecret);

// Acquire the access token. 
AccessToken accessToken = await sqlServerTokenProvider.GetTokenAsync(
    new TokenRequestContext(scopes: new string[]
    {
        "https://ossrdbms-aad.database.windows.net/.default"
    }));

// Combine the token with the connection string from the environment variables provided by Service Connector.
string connectionString =
    $"{Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CONNECTIONSTRING")};Password={accessToken.Token}";

// Establish the connection.
using (var connection = new NpgsqlConnection(connectionString))
{
    Console.WriteLine("Opening connection using access token...");
    connection.Open();
}

Java

1. Добавьте следующие зависимости в файл pom.xml :

   <dependency>
       <groupId>org.postgresql</groupId>
       <artifactId>postgresql</artifactId>
       <version>42.3.6</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity-extensions</artifactId>
       <version>1.1.5</version>
   </dependency>
   

2. Получите строка подключения из переменных среды и добавьте имя подключаемого модуля для подключения к базе данных:

   import java.sql.*;
   
   String url = System.getenv("AZURE_POSTGRESQL_CONNECTIONSTRING");
   String pluginName = "com.Azure.identity.extensions.jdbc.postgresql.AzurePostgresqlAuthenticationPlugin";  
   Connection connection = DriverManager.getConnection(url + "&authenticationPluginClassName=" + pluginName);
   

Дополнительные сведения см. на следующих ресурсах:

• Руководство. Подключение к Postgre База данных SQL из приложения контейнера Java Quarkus без секретов с помощью управляемого удостоверения
• Руководство. Подключение к Postgre База данных SQL из Java Tomcat Служба приложений без секретов с помощью управляемого удостоверения
• Краткое руководство. Использование Java и JDBC с гибким сервером База данных Azure для PostgreSQL
• Перенос приложения на использование бессерверных подключений с База данных Azure для PostgreSQL

SpringBoot

Если вы создаете подключение с параметром --client-type springbootSpring, соединитель службы задает свойства spring.datasource.azure.passwordless-enabledspring.datasource.urlи spring.datasource.username Azure Spring Apps.

Обновите приложение после учебника Привязка База данных Azure для PostgreSQL к приложению в Azure Spring Apps. Не забудьте удалить spring.datasource.password свойство конфигурации, если оно было задано ранее и добавить правильные зависимости в приложение Spring.

Дополнительные руководства см. в статье Использование Spring Data JDBC с База данных Azure для PostgreSQL и учебниками. Развертывание приложения Spring в Azure Spring Apps с помощью без пароля подключения к базе данных Azure.

Python

1. Установите зависимости.

   pip install azure-identity
   pip install psycopg2-binary
   pip freeze > requirements.txt # Save the dependencies to a file
   

2. Получение маркера доступа с помощью azure-identity библиотеки и использование маркера в качестве пароля. Получение сведений о подключении из переменных среды, добавленных соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   from azure.identity import DefaultAzureCredential
   import psycopg2
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # cred = DefaultAzureCredential()
   
   # For user-assigned identity.
   # managed_identity_client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)   
   
   # For service principal.
   # tenant_id = os.getenv('AZURE_POSTGRESQL_TENANTID')
   # client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # client_secret = os.getenv('AZURE_POSTGRESQL_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   # Acquire the access token
   accessToken = cred.get_token('https://ossrdbms-aad.database.windows.net/.default')
   
   # Combine the token with the connection string from the environment variables added by Service Connector to establish the connection.
   conn_string = os.getenv('AZURE_POSTGRESQL_CONNECTIONSTRING')
   conn = psycopg2.connect(conn_string + ' password=' + accessToken.token) 
   

Django

1. Установите зависимости.

   pip install azure-identity
   

2. Получение маркера доступа с помощью библиотеки с помощью azure-identity переменных среды, добавленных соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   from azure.identity import DefaultAzureCredential
   import psycopg2
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # credential = DefaultAzureCredential()
   
   # For user-assigned identity.
   # managed_identity_client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)    
   
   # For service principal.
   # tenant_id = os.getenv('AZURE_POSTGRESQL_TENANTID')
   # client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # client_secret = os.getenv('AZURE_POSTGRESQL_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   # Acquire the access token.
   accessToken = cred.get_token('https://ossrdbms-aad.database.windows.net/.default')
   

3. В файле параметров получите сведения о базе данных Azure PostgreSQL из переменных среды, добавленных службой Service Connector. Используйте accessToken полученный на предыдущем шаге для доступа к базе данных.

   # In your setting file, eg. settings.py
   host = os.getenv('AZURE_POSTGRESQL_HOST')
   user = os.getenv('AZURE_POSTGRESQL_USER')
   password = accessToken.token # this is accessToken acquired from above step.
   database = os.getenv('AZURE_POSTGRESQL_NAME')
   
   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql_psycopg2',
           'NAME': database,
           'USER': user,
           'PASSWORD': password,
           'HOST': host,
           'PORT': '5432',  # Port is 5432 by default 
           'OPTIONS': {'sslmode': 'require'},
       }
   }
   

Go

1. Установите зависимости.

   go get github.com/lib/pq
   go get "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   go get "github.com/Azure/azure-sdk-for-go/sdk/azcore"
   

2. В коде получите маркер доступа с помощью azidentity, а затем используйте его в качестве пароля для подключения к Azure PostgreSQL, а также сведения о подключении, предоставляемые соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   import (
   "database/sql"
   "fmt"
   "os"
   
   "context"
   
   "github.com/Azure/azure-sdk-for-go/sdk/azcore/policy"
   "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   
    _ "github.com/lib/pq"
   )    
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // For system-assigned identity.
   // cred, err := azidentity.NewDefaultAzureCredential(nil)
   
   // For user-assigned identity.
   // clientid := os.Getenv("AZURE_POSTGRESQL_CLIENTID")
   // azidentity.ManagedIdentityCredentialOptions.ID := clientid
   // options := &azidentity.ManagedIdentityCredentialOptions{ID: clientid}
   // cred, err := azidentity.NewManagedIdentityCredential(options)
   
   // For service principal.
   // clientid := os.Getenv("AZURE_POSTGRESQL_CLIENTID")
   // tenantid := os.Getenv("AZURE_POSTGRESQL_TENANTID")
   // clientsecret := os.Getenv("AZURE_POSTGRESQL_CLIENTSECRET")
   // cred, err := azidentity.NewClientSecretCredential(tenantid, clientid, clientsecret, &azidentity.ClientSecretCredentialOptions{})
   
   if err != nil {
       // error handling
   }
   
   // Acquire the access token
   ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
   token, err := cred.GetToken(ctx, policy.TokenRequestOptions{
       Scopes: []string("https://ossrdbms-aad.database.windows.net/.default"),
   })
   
   // Combine the token with the connection string from the environment variables added by Service Connector to establish the connection.
   connectionString := os.Getenv("AZURE_POSTGRESQL_CONNECTIONSTRING") + " password=" + token.Token
   
   conn, err := sql.Open("postgres", connectionString)
    if err != nil {
    	panic(err)
    }
   
    conn.Close()
   

NodeJS

1. Установите зависимости.

   npm install --save @azure/identity
   npm install --save pg
   

2. В коде получите маркер доступа с помощью @azure/identity и сведения о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Объедините их для установления соединения. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   import { DefaultAzureCredential, ClientSecretCredential } from "@azure/identity";
   const { Client } = require('pg');
   
   // Uncomment the following lines corresponding to the authentication type you want to use.  
   // For system-assigned identity.
   // const credential = new DefaultAzureCredential();
   
   // For user-assigned identity.
   // const clientId = process.env.AZURE_POSTGRESQL_CLIENTID;
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: clientId
   // });
   
   // For service principal.
   // const tenantId = process.env.AZURE_POSTGRESQL_TENANTID;
   // const clientId = process.env.AZURE_POSTGRESQL_CLIENTID;
   // const clientSecret = process.env.AZURE_POSTGRESQL_CLIENTSECRET;
   
   // Acquire the access token.
   var accessToken = await credential.getToken('https://ossrdbms-aad.database.windows.net/.default');
   
   // Use the token and the connection information from the environment variables added by Service Connector to establish the connection.
   (async () => {
   const client = new Client({
       host: process.env.AZURE_POSTGRESQL_HOST,
       user: process.env.AZURE_POSTGRESQL_USER,
       password: accesstoken.token,
       database: process.env.AZURE_POSTGRESQL_DATABASE,
       port: Number(process.env.AZURE_POSTGRESQL_PORT) ,
       ssl: process.env.AZURE_POSTGRESQL_SSL
   });
   await client.connect();
   
   await client.end();
   })();
   

PHP

Для PHP нет подключаемого модуля или библиотеки для подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить и использовать в качестве пароля для подключения к базе данных. Маркер доступа можно получить с помощью REST API Azure.

1. В коде получите маркер доступа с помощью REST API с любимой библиотекой.

   Для назначаемых пользователем удостоверений и назначаемых системой удостоверений Служба приложений и контейнерных приложений предоставляет внутреннюю конечную точку REST для получения маркеров для управляемых удостоверений путем определения двух переменных среды: IDENTITY_ENDPOINT и IDENTITY_HEADER. Дополнительные сведения см . в справочнике по конечной точке REST. Получите маркер доступа, выполнив HTTP-запрос GET к конечной точке удостоверения и используя https://ossrdbms-aad.database.windows.net его как resource в запросе. Для удостоверения, назначаемого пользователем, добавьте идентификатор клиента из переменных среды, добавленных соединителем службы в запрос, а также.

   Сведения о том, как получить маркер доступа, см. в запросе маркера доступа между службами Azure AD. Сделайте запрос POST областью https://ossrdbms-aad.database.windows.net/.default действия и с идентификатором клиента, идентификатором клиента и секретом клиента субъекта-службы из переменных среды, добавленных соединителем службы.

2. Объедините маркер доступа и sting подключения PostgreSQL из переменных среды, добавленных службой Соединителя служб для установления подключения.

   <?php
   $conn_string = sprintf("%s password=", getenv('AZURE_POSTGRESQL_CONNECTIONSTRING'), $access_token);
   $dbconn = pg_connect($conn_string);
   ?>
   

Ruby

Для Ruby нет подключаемого модуля или библиотеки для подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить и использовать в качестве пароля для подключения к базе данных. Маркер доступа можно получить с помощью REST API Azure.

1. Установите зависимости.

   gem install pg
   

2. В коде получите маркер доступа с помощью REST API и сведений о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Объедините их для установления соединения. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   Служба приложений и приложения-контейнеры предоставляют внутреннюю конечную точку REST для получения маркеров для управляемых удостоверений. Дополнительные сведения см . в справочнике по конечной точке REST.

   require 'pg'
   require 'dotenv/load'
   require 'net/http'
   require 'json'
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # uri = URI(ENV['IDENTITY_ENDPOINT'] + '?resource=https://ossrdbms-aad.database.windows.net&api-version=2019-08-01')
   # res = Net::HTTP.get_response(uri, {'X-IDENTITY-HEADER' => ENV['IDENTITY_HEADER'], 'Metadata' => 'true'})  
   
   # For user-assigned identity.
   # uri = URI(ENV[IDENTITY_ENDPOINT] + '?resource=https://ossrdbms-aad.database.windows.net&api-version=2019-08-01&client-id=' + ENV['AZURE_POSTGRESQL_CLIENTID'])
   # res = Net::HTTP.get_response(uri, {'X-IDENTITY-HEADER' => ENV['IDENTITY_HEADER'], 'Metadata' => 'true'})  
   
   # For service principal
   # uri = URI('https://login.microsoftonline.com/' + ENV['AZURE_POSTGRESQL_TENANTID'] + '/oauth2/v2.0/token')
   # params = {
   #     :grant_type => 'client_credentials',
   #     :client_id: => ENV['AZURE_POSTGRESQL_CLIENTID'],
   #     :client_secret => ENV['AZURE_POSTGRESQL_CLIENTSECRET'],
   #     :scope => 'https://ossrdbms-aad.database.windows.net/.default'
   # }
   # req = Net::HTTP::POST.new(uri)
   # req.set_form_data(params)
   # req['Content-Type'] = 'application/x-www-form-urlencoded'
   # res = Net::HTTP.start(uri.hostname, uri.port, :use_ssl => true) do |http|
   #   http.request(req)
   
   parsed = JSON.parse(res.body)
   access_token = parsed["access_token"]
   
   # Use the token and the connection string from the environment variables added by Service Connector to establish the connection.
   conn = PG::Connection.new(
       connection_string: ENV['AZURE_POSTGRESQL_CONNECTIONSTRING'] + " password="  + access_token,
   )
   

   Дополнительные сведения о получении маркера доступа для субъекта-службы см. в запросе маркера доступа к службе Azure AD.

Другое

Для других языков используйте свойства подключения, которые соединитель службы задает переменным среды для подключения к базе данных. Сведения об переменной среды см. в разделе "Интеграция База данных Azure для PostgreSQL с соединителем службы".

Затем, если вы создали таблицы и последовательности в гибком сервере PostgreSQL перед использованием соединителя служб, необходимо подключиться как владелец и предоставить разрешение, созданное <aad-username> соединителем службы. Имя пользователя из строка подключения или конфигурации, заданное соединителем службы, должно выглядеть следующим образомaad_<connection name>. Если вы используете портал Azure, нажмите кнопку развертывания рядом с столбцом Service Type и получите значение. Если вы используете Azure CLI, проверьте configurations выходные данные команды CLI.

Затем выполните запрос, чтобы предоставить разрешение

az extension add --name rdbms-connect

az postgres flexible-server execute -n <postgres-name> -u <owner-username> -p "<owner-password>" -d <database-name> --querytext "GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO \"<aad-username>\";GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO \"<aad username>\";"

И <owner-username> <owner-password> является владельцем существующей таблицы, которая может предоставлять разрешения другим пользователям. <aad-username> — это пользователь, созданный с помощью соединителя службы. Замените их фактическим значением.

Проверьте результат с помощью команды:

az postgres flexible-server execute -n <postgres-name> -u <owner-username> -p "<owner-password>" -d <database-name> --querytext "SELECT distinct(table_name) FROM information_schema.table_privileges WHERE grantee='<aad-username>' AND table_schema='public';" --output table

Строка подключения

.NET

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения .NET PostgreSQL	Server=<PostgreSQL-server-name>.postgres.database.azure.com;Database=<database-name>;Port=5432;Ssl Mode=Require;User Id=<username>;

Java

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения PostgreSQL для JDBC	jdbc:postgresql://<PostgreSQL-server-name>.postgres.database.azure.com:5432/<database-name>?sslmode=require&user=<username>&password=<password>

SpringBoot

Свойства приложения	Description	Пример значения
spring.datasource.url	URL-адрес базы данных	jdbc:postgresql://<PostgreSQL-server-name>.postgres.database.azure.com:5432/<database-name>?sslmode=require
spring.datasource.username	Имя пользователя базы данных	<username>
spring.datasource.password	Пароль базы данных	<password>

Python

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения для psycopg2	dbname=<database-name> host=<PostgreSQL-server-name>.postgres.database.azure.com port=5432 sslmode=require user=<username> password=<password>

Django

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_NAME	Имя базы данных	<database-name>
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USER	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_PASSWORD	Пароль базы данных	<database-password>

Go

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Go PostgreSQL строка подключения	host=<PostgreSQL-server-name>.postgres.database.azure.com dbname=<database-name> sslmode=require user=<username> password=<password>

NodeJS

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USER	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_PASSWORD	Пароль базы данных	<password>
AZURE_POSTGRESQL_DATABASE	Имя базы данных	<database-name>
AZURE_POSTGRESQL_PORT	Номер порта	5432
AZURE_POSTGRESQL_SSL	Параметр SSL	true

PHP

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения PHP на собственном языке PostgreSQL	host=<PostgreSQL-server-name>.postgres.database.azure.com port=5432 dbname=<database-name> sslmode=require user=<username> password=<password>

Ruby

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CONNECTIONSTRING	Ruby PostgreSQL строка подключения	host=<your-postgres-server-name>.postgres.database.azure.com port=5432 dbname=<database-name> sslmode=require user=<username> password=<password>

Другое

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USERNAME	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_DATABASE	Имя базы данных	<database-name>
AZURE_POSTGRESQL_PORT	Номер порта	5432
AZURE_POSTGRESQL_SSL	Параметр SSL	true
AZURE_POSTGRESQL_PASSWORD	Пароль базы данных	<password>

Пример кода

Ознакомьтесь с инструкциями и кодом ниже, чтобы подключиться к База данных Azure для PostgreSQL с помощью строка подключения.

.NET

1. Установите зависимости. Следуйте инструкциям по установке Npgsql
2. В коде получите строка подключения PostgreSQL из переменных среды, добавленных службой Service Connector. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

   using System;
   using Npgsql;
   
   string connectionString = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CONNECTIONSTRING");
   using (NpgsqlConnection connection = new NpgsqlConnection(connectionString))
   {
       connection.Open();
   }
   

Java

1. Установите зависимости. Следуйте инструкциям по установке pgJDBC.
2. В коде получите строка подключения PostgreSQL из переменных среды, добавленных службой Service Connector. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

   import java.sql.Connection;
   import java.sql.DriverManager;
   import java.sql.SQLException;
   
   String connectionString = System.getenv("AZURE_POSTGRESQL_CONNECTIONSTRING");
   Connection connection = null;
   try {
       connection = DriverManager.getConnection(connectionString);
       System.out.println("Connection successful!");
   } catch (SQLException e){
       System.out.println(e.getMessage());
   }
   

SpringBoot

1. Установите модуль Spring Cloud Azure Starter JDBC PostgreSQL, добавив в файл следующие зависимости pom.xml . Найдите версию Spring Cloud Azure здесь.

   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>com.azure.spring</groupId>
               <artifactId>spring-cloud-azure-dependencies</artifactId>
               <version>4.11.0</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
           <dependency>
               <groupId>com.azure.spring</groupId>
               <artifactId>spring-cloud-azure-starter-jdbc-postgresql</artifactId>
           </dependency>
       </dependencies>
   </dependencyManagement>
   

2. Настройте приложение Spring App, дополнительные сведения в этом разделе. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

Python

1. Установите зависимости. Следуйте инструкциям по установке psycopg2.
2. В коде получите сведения о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

   import os
   import psycopg2
   
   connection_string = os.getenv('AZURE_POSTGRESQL_CONNECTIONSTRING')
   connection = psycopg2.connect(connection_string)
   print("Connection established")
   
   connection.close()
   

Django

1. Установите зависимости. Следуйте инструкциям по установке Django и psycopg2.

   pip install django
   pip install psycopg2
   

2. В файле параметров получите сведения о базе данных PostgreSQL из переменных среды, добавленных службой Service Connector. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

   # in your setting file, eg. settings.py
   host = os.getenv('AZURE_POSTGRESQL_HOST')
   user = os.getenv('AZURE_POSTGRESQL_USER')
   password = os.getenv('AZURE_POSTGRESQL_PASSWORD')
   database = os.getenv('AZURE_POSTGRESQL_NAME')
   
   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql_psycopg2',
           'NAME': database,
           'USER': user,
           'PASSWORD': password,
           'HOST': host,
           'PORT': '5432',  # Port is 5432 by default 
           'OPTIONS': {'sslmode': 'require'},
       }
   }
   

Go

1. Установите зависимости.

   go get github.com/lib/pq
   

2. В коде получите строка подключения PostgreSQL из переменных среды, добавленных службой Service Connector. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

   import (
   "database/sql"
   "fmt"
   "os"
   
    _ "github.com/lib/pq"
   )
   
   connectionString := os.Getenv("AZURE_POSTGRESQL_CONNECTIONSTRING")
   conn, err := sql.Open("postgres", connectionString)
    if err != nil {
    	panic(err)
    }
   
    conn.Close()
   

NodeJS

1. Установите зависимости.

   npm install pg dotenv
   

2. В коде получите сведения о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

   const { Client } = require('pg');
   
   (async () => {
    const client = new Client({
        host: process.env.AZURE_POSTGRESQL_HOST,
        user: process.env.AZURE_POSTGRESQL_USER,
        password: process.env.AZURE_POSTGRESQL_PASSWORD,
        database: process.env.AZURE_POSTGRESQL_DATABASE,
        port: Number(process.env.AZURE_POSTGRESQL_PORT) ,
        ssl: process.env.AZURE_POSTGRESQL_SSL
    });
    await client.connect();
   
    await client.end();
   })();
   

PHP

1. В коде получите сведения о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

   <?php
   $conn_string = getenv('AZURE_POSTGRESQL_CONNECTIONSTRING');
   $dbconn = pg_connect($conn_string);
   ?>
   

Ruby

1. Установите зависимости.

   gem install pg
   

2. В коде получите сведения о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Чтобы задать конфигурации TSL для сервера PostgreSQL, выполните следующие действия.

   require 'pg'
   require 'dotenv/load'
   
   begin
       conn = PG::Connection.new(
           connection_string: ENV['AZURE_POSTGRESQL_CONNECTIONSTRING'],
       )
   rescue PG::Error => e
       puts e.message
   
   ensure
       connection.close if connection
   end
   

Другое

Для других языков используйте свойства подключения, которые соединитель службы задает переменным среды для подключения к базе данных. Сведения об переменной среды см. в разделе "Интеграция База данных Azure для PostgreSQL с соединителем службы".

Субъект-служба

.NET

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения .NET PostgreSQL	Server=<PostgreSQL-server-name>.postgres.database.azure.com;Database=<database-name>;Port=5432;Ssl Mode=Require;User Id=<username>;

Java

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения PostgreSQL для JDBC	jdbc:postgresql://<PostgreSQL-server-name>.postgres.database.azure.com:5432/<database-name>?sslmode=require&user=<username>

SpringBoot

Свойства приложения	Description	Пример значения
spring.datasource.azure.passwordless-enabled	Включение проверки подлинности без пароля	true
spring.cloud.azure.credential.client-id	Идентификатор клиента	<client-ID>
spring.cloud.azure.credential.client-secret	Секрет клиента	<client-secret>
spring.cloud.azure.credential.tenant-id	Идентификатор клиента	<tenant-ID>
spring.datasource.url	URL-адрес базы данных	jdbc:postgresql://<PostgreSQL-server-name>.postgres.database.azure.com:5432/<database-name>?sslmode=require
spring.datasource.username	Имя пользователя базы данных	username

Python

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения для psycopg2	dbname=<database-name> host=<PostgreSQL-server-name>.postgres.database.azure.com port=5432 sslmode=require user=<username>

Django

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_NAME	Имя базы данных	<database-name>
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USER	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>

Go

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Go PostgreSQL строка подключения	host=<PostgreSQL-server-name>.postgres.database.azure.com dbname=<database-name> sslmode=require user=<username>

NodeJS

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USER	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_DATABASE	Имя базы данных	<database-name>
AZURE_POSTGRESQL_PORT	Номер порта	5432
AZURE_POSTGRESQL_SSL	Параметр SSL	true
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>

PHP

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Строка подключения PHP на собственном языке PostgreSQL	host=<PostgreSQL-server-name>.postgres.database.azure.com port=5432 dbname=<database-name> sslmode=require user=<username>

Ruby

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>
AZURE_POSTGRESQL_CONNECTIONSTRING	Ruby PostgreSQL строка подключения	host=<your-postgres-server-name>.postgres.database.azure.com port=5432 dbname=<database-name> sslmode=require user=<username>

Другое

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_POSTGRESQL_HOST	URL-адрес узла базы данных	<PostgreSQL-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_USERNAME	Имя пользователя базы данных	<username>
AZURE_POSTGRESQL_DATABASE	Имя базы данных	<database-name>
AZURE_POSTGRESQL_PORT	Номер порта	5432
AZURE_POSTGRESQL_SSL	Параметр SSL	true
AZURE_POSTGRESQL_CLIENTID	Идентификатор клиента	<identity-client-ID>
AZURE_POSTGRESQL_CLIENTSECRET	Секрет клиента	<client-secret>
AZURE_POSTGRESQL_TENANTID	Идентификатор клиента	<tenant-ID>

Пример кода

Ознакомьтесь с инструкциями и кодом ниже, чтобы подключиться к База данных Azure для PostgreSQL с помощью субъекта-службы.

.NET

Для .NET нет подключаемого модуля или библиотеки для поддержки подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить с помощью клиентской библиотеки, такой как Azure.Identity. Затем вы можете использовать маркер доступа в качестве пароля для подключения к базе данных. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

using Azure.Identity;
using Azure.Core;
using Npgsql;

// Uncomment the following lines corresponding to the authentication type you want to use.
// For system-assigned identity.
// var sqlServerTokenProvider = new DefaultAzureCredential();

// For user-assigned identity.
// var sqlServerTokenProvider = new DefaultAzureCredential(
//     new DefaultAzureCredentialOptions
//     {
//         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTID");
//     }
// );

// For service principal.
// var tenantId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTSECRET");
// var sqlServerTokenProvider = new ClientSecretCredential(tenantId, clientId, clientSecret);

// Acquire the access token. 
AccessToken accessToken = await sqlServerTokenProvider.GetTokenAsync(
    new TokenRequestContext(scopes: new string[]
    {
        "https://ossrdbms-aad.database.windows.net/.default"
    }));

// Combine the token with the connection string from the environment variables provided by Service Connector.
string connectionString =
    $"{Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CONNECTIONSTRING")};Password={accessToken.Token}";

// Establish the connection.
using (var connection = new NpgsqlConnection(connectionString))
{
    Console.WriteLine("Opening connection using access token...");
    connection.Open();
}

Java

1. Добавьте следующие зависимости в файл pom.xml :

   <dependency>
       <groupId>org.postgresql</groupId>
       <artifactId>postgresql</artifactId>
       <version>42.3.6</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity-extensions</artifactId>
       <version>1.1.5</version>
   </dependency>
   

2. Получите строка подключения из переменных среды и добавьте имя подключаемого модуля для подключения к базе данных:

   import java.sql.*;
   
   String url = System.getenv("AZURE_POSTGRESQL_CONNECTIONSTRING");
   String pluginName = "com.Azure.identity.extensions.jdbc.postgresql.AzurePostgresqlAuthenticationPlugin";  
   Connection connection = DriverManager.getConnection(url + "&authenticationPluginClassName=" + pluginName);
   

Дополнительные сведения см. на следующих ресурсах:

• Руководство. Подключение к Postgre База данных SQL из приложения контейнера Java Quarkus без секретов с помощью управляемого удостоверения
• Руководство. Подключение к Postgre База данных SQL из Java Tomcat Служба приложений без секретов с помощью управляемого удостоверения
• Краткое руководство. Использование Java и JDBC с гибким сервером База данных Azure для PostgreSQL
• Перенос приложения на использование бессерверных подключений с База данных Azure для PostgreSQL

SpringBoot

Если вы создаете подключение с параметром --client-type springbootSpring, соединитель службы задает свойства spring.datasource.azure.passwordless-enabledspring.datasource.urlи spring.datasource.username Azure Spring Apps.

Обновите приложение после учебника Привязка База данных Azure для PostgreSQL к приложению в Azure Spring Apps. Не забудьте удалить spring.datasource.password свойство конфигурации, если оно было задано ранее и добавить правильные зависимости в приложение Spring.

Дополнительные руководства см. в статье Использование Spring Data JDBC с База данных Azure для PostgreSQL и учебниками. Развертывание приложения Spring в Azure Spring Apps с помощью без пароля подключения к базе данных Azure.

Python

1. Установите зависимости.

   pip install azure-identity
   pip install psycopg2-binary
   pip freeze > requirements.txt # Save the dependencies to a file
   

2. Получение маркера доступа с помощью azure-identity библиотеки и использование маркера в качестве пароля. Получение сведений о подключении из переменных среды, добавленных соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   from azure.identity import DefaultAzureCredential
   import psycopg2
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # cred = DefaultAzureCredential()
   
   # For user-assigned identity.
   # managed_identity_client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)   
   
   # For service principal.
   # tenant_id = os.getenv('AZURE_POSTGRESQL_TENANTID')
   # client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # client_secret = os.getenv('AZURE_POSTGRESQL_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   # Acquire the access token
   accessToken = cred.get_token('https://ossrdbms-aad.database.windows.net/.default')
   
   # Combine the token with the connection string from the environment variables added by Service Connector to establish the connection.
   conn_string = os.getenv('AZURE_POSTGRESQL_CONNECTIONSTRING')
   conn = psycopg2.connect(conn_string + ' password=' + accessToken.token) 
   

Django

1. Установите зависимости.

   pip install azure-identity
   

2. Получение маркера доступа с помощью библиотеки с помощью azure-identity переменных среды, добавленных соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   from azure.identity import DefaultAzureCredential
   import psycopg2
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # credential = DefaultAzureCredential()
   
   # For user-assigned identity.
   # managed_identity_client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)    
   
   # For service principal.
   # tenant_id = os.getenv('AZURE_POSTGRESQL_TENANTID')
   # client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
   # client_secret = os.getenv('AZURE_POSTGRESQL_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   # Acquire the access token.
   accessToken = cred.get_token('https://ossrdbms-aad.database.windows.net/.default')
   

3. В файле параметров получите сведения о базе данных Azure PostgreSQL из переменных среды, добавленных службой Service Connector. Используйте accessToken полученный на предыдущем шаге для доступа к базе данных.

   # In your setting file, eg. settings.py
   host = os.getenv('AZURE_POSTGRESQL_HOST')
   user = os.getenv('AZURE_POSTGRESQL_USER')
   password = accessToken.token # this is accessToken acquired from above step.
   database = os.getenv('AZURE_POSTGRESQL_NAME')
   
   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql_psycopg2',
           'NAME': database,
           'USER': user,
           'PASSWORD': password,
           'HOST': host,
           'PORT': '5432',  # Port is 5432 by default 
           'OPTIONS': {'sslmode': 'require'},
       }
   }
   

Go

1. Установите зависимости.

   go get github.com/lib/pq
   go get "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   go get "github.com/Azure/azure-sdk-for-go/sdk/azcore"
   

2. В коде получите маркер доступа с помощью azidentity, а затем используйте его в качестве пароля для подключения к Azure PostgreSQL, а также сведения о подключении, предоставляемые соединителем службы. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   import (
   "database/sql"
   "fmt"
   "os"
   
   "context"
   
   "github.com/Azure/azure-sdk-for-go/sdk/azcore/policy"
   "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   
    _ "github.com/lib/pq"
   )    
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // For system-assigned identity.
   // cred, err := azidentity.NewDefaultAzureCredential(nil)
   
   // For user-assigned identity.
   // clientid := os.Getenv("AZURE_POSTGRESQL_CLIENTID")
   // azidentity.ManagedIdentityCredentialOptions.ID := clientid
   // options := &azidentity.ManagedIdentityCredentialOptions{ID: clientid}
   // cred, err := azidentity.NewManagedIdentityCredential(options)
   
   // For service principal.
   // clientid := os.Getenv("AZURE_POSTGRESQL_CLIENTID")
   // tenantid := os.Getenv("AZURE_POSTGRESQL_TENANTID")
   // clientsecret := os.Getenv("AZURE_POSTGRESQL_CLIENTSECRET")
   // cred, err := azidentity.NewClientSecretCredential(tenantid, clientid, clientsecret, &azidentity.ClientSecretCredentialOptions{})
   
   if err != nil {
       // error handling
   }
   
   // Acquire the access token
   ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
   token, err := cred.GetToken(ctx, policy.TokenRequestOptions{
       Scopes: []string("https://ossrdbms-aad.database.windows.net/.default"),
   })
   
   // Combine the token with the connection string from the environment variables added by Service Connector to establish the connection.
   connectionString := os.Getenv("AZURE_POSTGRESQL_CONNECTIONSTRING") + " password=" + token.Token
   
   conn, err := sql.Open("postgres", connectionString)
    if err != nil {
    	panic(err)
    }
   
    conn.Close()
   

NodeJS

1. Установите зависимости.

   npm install --save @azure/identity
   npm install --save pg
   

2. В коде получите маркер доступа с помощью @azure/identity и сведения о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Объедините их для установления соединения. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   import { DefaultAzureCredential, ClientSecretCredential } from "@azure/identity";
   const { Client } = require('pg');
   
   // Uncomment the following lines corresponding to the authentication type you want to use.  
   // For system-assigned identity.
   // const credential = new DefaultAzureCredential();
   
   // For user-assigned identity.
   // const clientId = process.env.AZURE_POSTGRESQL_CLIENTID;
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: clientId
   // });
   
   // For service principal.
   // const tenantId = process.env.AZURE_POSTGRESQL_TENANTID;
   // const clientId = process.env.AZURE_POSTGRESQL_CLIENTID;
   // const clientSecret = process.env.AZURE_POSTGRESQL_CLIENTSECRET;
   
   // Acquire the access token.
   var accessToken = await credential.getToken('https://ossrdbms-aad.database.windows.net/.default');
   
   // Use the token and the connection information from the environment variables added by Service Connector to establish the connection.
   (async () => {
   const client = new Client({
       host: process.env.AZURE_POSTGRESQL_HOST,
       user: process.env.AZURE_POSTGRESQL_USER,
       password: accesstoken.token,
       database: process.env.AZURE_POSTGRESQL_DATABASE,
       port: Number(process.env.AZURE_POSTGRESQL_PORT) ,
       ssl: process.env.AZURE_POSTGRESQL_SSL
   });
   await client.connect();
   
   await client.end();
   })();
   

PHP

Для PHP нет подключаемого модуля или библиотеки для подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить и использовать в качестве пароля для подключения к базе данных. Маркер доступа можно получить с помощью REST API Azure.

1. В коде получите маркер доступа с помощью REST API с любимой библиотекой.

   Для назначаемых пользователем удостоверений и назначаемых системой удостоверений Служба приложений и контейнерных приложений предоставляет внутреннюю конечную точку REST для получения маркеров для управляемых удостоверений путем определения двух переменных среды: IDENTITY_ENDPOINT и IDENTITY_HEADER. Дополнительные сведения см . в справочнике по конечной точке REST. Получите маркер доступа, выполнив HTTP-запрос GET к конечной точке удостоверения и используя https://ossrdbms-aad.database.windows.net его как resource в запросе. Для удостоверения, назначаемого пользователем, добавьте идентификатор клиента из переменных среды, добавленных соединителем службы в запрос, а также.

   Сведения о том, как получить маркер доступа, см. в запросе маркера доступа между службами Azure AD. Сделайте запрос POST областью https://ossrdbms-aad.database.windows.net/.default действия и с идентификатором клиента, идентификатором клиента и секретом клиента субъекта-службы из переменных среды, добавленных соединителем службы.

2. Объедините маркер доступа и sting подключения PostgreSQL из переменных среды, добавленных службой Соединителя служб для установления подключения.

   <?php
   $conn_string = sprintf("%s password=", getenv('AZURE_POSTGRESQL_CONNECTIONSTRING'), $access_token);
   $dbconn = pg_connect($conn_string);
   ?>
   

Ruby

Для Ruby нет подключаемого модуля или библиотеки для подключений без пароля. Маркер доступа для управляемого удостоверения или субъекта-службы можно получить и использовать в качестве пароля для подключения к базе данных. Маркер доступа можно получить с помощью REST API Azure.

1. Установите зависимости.

   gem install pg
   

2. В коде получите маркер доступа с помощью REST API и сведений о подключении PostgreSQL из переменных среды, добавленных службой Service Connector. Объедините их для установления соединения. При использовании приведенного ниже кода раскомментируйте часть фрагмента кода для используемого типа проверки подлинности.

   Служба приложений и приложения-контейнеры предоставляют внутреннюю конечную точку REST для получения маркеров для управляемых удостоверений. Дополнительные сведения см . в справочнике по конечной точке REST.

   require 'pg'
   require 'dotenv/load'
   require 'net/http'
   require 'json'
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # For system-assigned identity.
   # uri = URI(ENV['IDENTITY_ENDPOINT'] + '?resource=https://ossrdbms-aad.database.windows.net&api-version=2019-08-01')
   # res = Net::HTTP.get_response(uri, {'X-IDENTITY-HEADER' => ENV['IDENTITY_HEADER'], 'Metadata' => 'true'})  
   
   # For user-assigned identity.
   # uri = URI(ENV[IDENTITY_ENDPOINT] + '?resource=https://ossrdbms-aad.database.windows.net&api-version=2019-08-01&client-id=' + ENV['AZURE_POSTGRESQL_CLIENTID'])
   # res = Net::HTTP.get_response(uri, {'X-IDENTITY-HEADER' => ENV['IDENTITY_HEADER'], 'Metadata' => 'true'})  
   
   # For service principal
   # uri = URI('https://login.microsoftonline.com/' + ENV['AZURE_POSTGRESQL_TENANTID'] + '/oauth2/v2.0/token')
   # params = {
   #     :grant_type => 'client_credentials',
   #     :client_id: => ENV['AZURE_POSTGRESQL_CLIENTID'],
   #     :client_secret => ENV['AZURE_POSTGRESQL_CLIENTSECRET'],
   #     :scope => 'https://ossrdbms-aad.database.windows.net/.default'
   # }
   # req = Net::HTTP::POST.new(uri)
   # req.set_form_data(params)
   # req['Content-Type'] = 'application/x-www-form-urlencoded'
   # res = Net::HTTP.start(uri.hostname, uri.port, :use_ssl => true) do |http|
   #   http.request(req)
   
   parsed = JSON.parse(res.body)
   access_token = parsed["access_token"]
   
   # Use the token and the connection string from the environment variables added by Service Connector to establish the connection.
   conn = PG::Connection.new(
       connection_string: ENV['AZURE_POSTGRESQL_CONNECTIONSTRING'] + " password="  + access_token,
   )
   

   Дополнительные сведения о получении маркера доступа для субъекта-службы см. в запросе маркера доступа к службе Azure AD.

Другое

Для других языков используйте свойства подключения, которые соединитель службы задает переменным среды для подключения к базе данных. Сведения об переменной среды см. в разделе "Интеграция База данных Azure для PostgreSQL с соединителем службы".

Затем, если вы создали таблицы и последовательности в гибком сервере PostgreSQL перед использованием соединителя служб, необходимо подключиться как владелец и предоставить разрешение, созданное <aad-username> соединителем службы. Имя пользователя из строка подключения или конфигурации, заданное соединителем службы, должно выглядеть следующим образомaad_<connection name>. Если вы используете портал Azure, нажмите кнопку развертывания рядом с столбцом Service Type и получите значение. Если вы используете Azure CLI, проверьте configurations выходные данные команды CLI.

Затем выполните запрос, чтобы предоставить разрешение

az extension add --name rdbms-connect

az postgres flexible-server execute -n <postgres-name> -u <owner-username> -p "<owner-password>" -d <database-name> --querytext "GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO \"<aad-username>\";GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO \"<aad username>\";"

И <owner-username> <owner-password> является владельцем существующей таблицы, которая может предоставлять разрешения другим пользователям. <aad-username> — это пользователь, созданный с помощью соединителя службы. Замените их фактическим значением.

Проверьте результат с помощью команды:

az postgres flexible-server execute -n <postgres-name> -u <owner-username> -p "<owner-password>" -d <database-name> --querytext "SELECT distinct(table_name) FROM information_schema.table_privileges WHERE grantee='<aad-username>' AND table_schema='public';" --output table

Следующие шаги

Дополнительные сведения о соединителе служб см. в приведенных ниже учебниках.

относительно соединителя служб