Übung – Einrichten der pgvector-Erweiterung in Azure PostgresQL für die Verwendung mit Spring AI
In dieser Übung erstellen Sie eine Azure-Datenbank für flexible Serverinstanz für PostgreSQL, aktivieren die pgvector Erweiterung und erstellen die erforderliche Datenbankstruktur für die Verwendung mit der Spring AI-Abstraktion VectorStore .
Melden Sie sich über die Azure CLI bei Azure an
Verwenden Sie den folgenden Befehl, um sich bei Azure anzumelden:
az login
Festlegen von Parameterwerten
Verwenden Sie die folgenden Befehle, um einige Umgebungsvariablen festzulegen. Diese Werte werden an nachfolgende Befehle übergeben, um die Datenbank und die erforderlichen Ressourcen zu erstellen. Achten Sie darauf, die <...> Platzhalter durch Ihre eigenen Werte zu ersetzen. Der <server-name>-Wert muss weltweit eindeutig in ganz Azure sein. Eine einfache Möglichkeit, die Eindeutigkeit sicherzustellen, besteht darin, eine Kombination aus Ihren Initialen, dem heutigen Datum und einigen Bezeichnern zu verwenden , z. B. abc-031325-spring-ai-postgresql-server.
export RESOURCE_GROUP=<resource-group>
export LOCATION=<location>
export DB_SERVER_NAME=<server-name>
Verwenden Sie als Nächstes den folgenden Befehl, um Ihre öffentliche IP-Adresse in einer Umgebungsvariable zu speichern und in der Konsole anzuzeigen. Sie verwenden diesen Wert später in dieser Einheit, um den Zugriff auf die externe IP-Adresse des PostgreSQL-Servers zu beschränken. Durch Die Verwendung der öffentlichen IP-Adresse des computers, den Sie verwenden, kann nur Ihre IP-Adresse auf den Server zugreifen.
export PUBLIC_IP=$(curl -s ipinfo.io/ip)
echo "Start IP: $PUBLIC_IP"
Dieser Befehl sollte in den meisten Linux-Distributionen und in Git Bash funktionieren. Wenn dies nicht funktioniert, können Sie alternativ Ihre öffentliche IP-Adresse über https://whatismyipaddress.com/ erhalten.
Hinweis
Ihre IP-Adresse kann sich ändern. Wenn sich dies ändert, müssen Sie die entsprechende Firewallregel entsprechend aktualisieren.
Erstellen einer Ressourcengruppe
Erstellen Sie mit dem folgenden Befehl eine Ressourcengruppe. Eine Azure-Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen bereitgestellt und verwaltet werden.
az group create --name $RESOURCE_GROUP --location $LOCATION
Erstellen einer Instanz von Azure Database for PostgreSQL – flexibler Server
Verwenden Sie den folgenden Befehl, um eine Datenbankinstanz für Entwicklungszwecke zu erstellen. Die platzbare Stufe ist eine kostengünstige Stufe für Workloads, die keine konsistente Leistung erfordern.
az postgres flexible-server create \
--resource-group $RESOURCE_GROUP \
--name $DB_SERVER_NAME \
--location $LOCATION \
--tier Burstable \
--sku-name standard_b1ms \
--active-directory-auth enabled \
--public-access $PUBLIC_IP \
--version 16
Die Ausführung dieses Befehls dauert einige Minuten. Nach Abschluss des Vorgangs wird die Ausgabe ähnlich wie im folgenden Beispiel angezeigt:
{
"connectionString": "postgresql://<admin-user>:<admin-password>@<name>.postgres.database.azure.com/None?sslmode=require",
"databaseName": null,
"firewallName": "FirewallIPAddress_<timestamp>",
"host": "<name>.postgres.database.azure.com",
"id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<name>",
"location": "<region>",
"password": "<admin-password>",
"resourceGroup": "<resource-group>",
"skuname": "<sku-name>",
"username": "<admin-user>",
"version": "<version>"
}
Verwenden Sie zum Testen nur den folgenden Befehl, um eine Firewallregel zu erstellen, um den Zugriff auf einen breiteren IP-Bereich zu ermöglichen:
az postgres flexible-server firewall-rule create \
--resource-group $RESOURCE_GROUP \
--name $DB_SERVER_NAME \
--rule-name allowiprange \
--start-ip-address 0.0.0.0 \
--end-ip-address 255.255.255.255
Gewähren des Administratorzugriffs auf Ihre Entra-ID
Verwenden Sie den folgenden Befehl, um die object id für Ihre Entra ID abzurufen.
export USER_OBJECT_ID=$(az ad signed-in-user show \
--query id \
--output tsv \
| tr -d '\r')
Verwenden Sie den folgenden Befehl, um Administratorzugriff auf Ihre Entra-ID zu gewähren:
az postgres flexible-server ad-admin create \
--resource-group $RESOURCE_GROUP \
--server-name $DB_SERVER_NAME \
--object-id $USER_OBJECT_ID \
--display-name azureuser
Zulassen der erforderlichen Erweiterungen für pgvector
Bevor Sie die erforderlichen pgvectorErweiterungen aktivieren können, müssen Sie sie mit dem folgenden Befehl zulassen:
az postgres flexible-server parameter set \
--resource-group $RESOURCE_GROUP \
--server-name $DB_SERVER_NAME \
--name azure.extensions \
--value vector,hstore,uuid-ossp
Überprüfen der Konnektivität mit Ihrer Datenbank
Verwenden Sie den folgenden Befehl, um den vollqualifizierten Hostnamen für Ihren Datenbankserver abzurufen:
export PGHOST=$(az postgres flexible-server show \
--resource-group $RESOURCE_GROUP \
--name $DB_SERVER_NAME \
--query fullyQualifiedDomainName \
--output tsv \
| tr -d '\r')
Verwenden Sie den folgenden Befehl, um ein Zugriffstoken für Ihre Benutzer-ID abzurufen:
export PGPASSWORD="$(az account get-access-token \
--resource https://ossrdbms-aad.database.windows.net \
--query accessToken \
--output tsv)"
Verwenden Sie den folgenden Befehl, um die Verbindung mit der Datenbank herzustellen:
psql "host=$PGHOST dbname=postgres user=azureuser sslmode=require"
Das folgende Ergebnis ist typisch:
psql (14.13, server 16.4)
WARNING: psql major version 14, server major version 16.
Some psql features might not work.
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.
postgres=>
Nachdem diese Regel erstellt wurde, können Sie die Regel mithilfe von az postgres flexible-server firewall-rule update aktualisieren.
Zusammenfassung der Einheit
Sie verfügen jetzt über eine vektorfähige PostgreSQL-Datenbank, die Vektor-Ähnlichkeitssuchfunktionen bereitstellt.