Freigeben über

Konfigurieren von Serverparametern in Azure Database for PostgreSQL – Flexibler Server

  • Artikel

GILT FÜR: Azure Database for PostgreSQL – Flexibler Server

Sie können Konfigurationsparameter für eine Instanz von Azure Database for PostgreSQL – Flexibler Server auflisten, anzeigen und aktualisieren.

Parameteranpassung

Es stehen verschiedene Methoden und Ebenen zur Verfügung, um Ihre Parameter entsprechend Ihren spezifischen Anforderungen anzupassen.

Globale Ebene

Um die aktuell konfigurierten Werte für Serverparameter anzuzeigen oder um sie global auf Instanz- oder Serverebene zu ändern, können Sie die Seite Serverparameter im Azure-Portal verwenden. Sie können auch global mit Serverparametern interagieren, indem Sie die CLI, die REST API, Azure Resource Manager-Vorlagen oder IaC-Tools von Drittanbietern verwenden.

Hinweis

Da Azure Database for PostgreSQL ein verwalteter Datenbankdienst ist, haben Benutzer keinen Host- oder Betriebssystemzugriff, um Konfigurationsdateien wie postgresql.conf anzuzeigen oder zu ändern. Der Inhalt der Dateien wird basierend auf den von Ihnen vorgenommenen Parameteränderungen automatisch aktualisiert.

In diesem Artikel finden Sie auch Abschnitte zur globalen Interaktion mit Serverparametern:

Granulare Ebenen

Sie können Parameter auf granulareren Ebenen anpassen. Diese Anpassungen setzen global festgelegte Werte außer Kraft. Der Umfang und die Dauer hängen von der Ebene ab, auf der Sie sie festlegen:

  • Datenbankebene: Verwenden Sie den Befehl ALTER DATABASE für datenbankspezifische Konfigurationen.

  • Rollen- oder Benutzerebene: Verwenden Sie den Befehl ALTER USER für benutzerbezogene Einstellungen.

  • Funktions-, Prozedurebene: Beim Definieren einer Funktion oder Prozedur können Sie die Konfigurationsparameter angeben oder ändern, die festgelegt werden, wenn die Funktion aufgerufen wird.

  • Tabellenebene: Beispielsweise können Sie Parameter im Zusammenhang mit Autovacuum auf dieser Ebene ändern.

  • Sitzungsebene: Für die Dauer einer einzelnen Datenbanksitzung können Sie bestimmte Parameter anpassen. Diese Anpassung erleichtert PostgreSQL mit den folgenden SQL-Befehlen:

    • Mit dem Befehl SET nehmen Sie sitzungsspezifische Anpassungen vor. Diese Änderungen dienen während der aktuellen Sitzung als Standardeinstellungen. Der Zugriff auf diese Änderungen erfordert möglicherweise bestimmte SET-Berechtigungen, und die Einschränkungen für modifizierbare und schreibgeschützte Parameter, die oben beschrieben werden, gelten nicht. Die entsprechende SQL-Funktion ist set_config(setting_name, new_value, is_local).
    • Verwenden Sie den Befehl SHOW, um vorhandene Parametereinstellungen zu untersuchen. Die äquivalente SQL-Funktion ist current_setting(setting_name text).

Alle Serverparameter auflisten

Verwenden des Azure-Portals:

  1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

  2. Wählen Sie im Ressourcenmenü unter dem Abschnitt Einstellungen die Option Serverparameter aus. Auf der Seite werden eine Liste der Parameter, ihre konfigurierten Werte, optionale Einheiten, die Angabe, ob sie schreibgeschützt/dynamisch/statisch sind, und ihre Beschreibungen angezeigt.

    Screenshot der Seite „Serverparameter“.

  3. Wählen Sie das Symbol i (Information) oder bewegen Sie den Mauszeiger darüber, um die zulässigen Werte anzuzeigen, auf die jeder Parameter eingestellt werden kann. Je nach Datentyp des Parameters, der Zeichenfolge, Aufzählung, Ganzzahl, boolesch, numerisch oder Menge sein kann, variieren die zulässigen Werte. Dabei kann es sich um einen regulären Ausdruck, eine Werteliste, einen ganzzahligen Bereich, ein/aus, einen dezimalen Bereich bzw. eine Werteliste handeln.

    Screenshot der Sprechblase, die sich öffnet, wenn Sie den Mauszeiger über das Informationssymbol bewegen.

  4. Die Liste der von der Instanz unterstützten Serverparameter besteht aus mehreren hundert Elementen, die in Seiten mit jeweils 20 Elementen dargestellt werden. Unten auf der Seite befindet sich ein Steuerelement, das Ihnen mitteilt, an welcher Stelle Sie sich gerade befinden. Es gibt auch ein Steuerelement zum Blättern, mit dem Sie durch die gesamte Reihe von Seiten navigieren können.

    Screenshot des Steuerelements zum Blättern auf der Seite „Serverparameter“.

  5. Verwenden Sie bei Bedarf das Textfeld Suchen zum Filtern von Elementen..., um die Liste auf die Parameter einzugrenzen, die den Suchbegriff in ihrem Namen oder in ihrer Beschreibung enthalten.

    Screenshot der Suche in „Serverparametern“.

Die Spalte Parametertyp kann jeden der folgenden Werte für jeden Parameter anzeigen:

Parametertyp Beschreibung
Static Erfordert einen Serverneustart, um die Änderung wirksam zu machen.
Dynamisch Kann geändert werden, ohne dass die Serverinstanz neu gestartet werden muss. Änderungen gelten jedoch nur für neue Verbindungen, die nach der Änderung eingerichtet wurden.
Schreibgeschützt Aufgrund der kritischen Rolle bei der Aufrechterhaltung von Zuverlässigkeit, Sicherheit oder anderen betrieblichen Aspekten des Diensts nicht konfigurierbar.

Serverparameter mit geänderten Standardwerten auflisten

Verwenden des Azure-Portals:

  1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

  2. Wählen Sie im Ressourcenmenü unter dem Abschnitt Einstellungen die Option Serverparameter und wählen Sie dann Geändert aus. Auf der Seite wird eine Liste der Parameter angezeigt, deren aktuell eingestellter Wert vom Standardwert abweicht.

    Screenshot der geänderten Serverparameter.

Statische Serverparameter mit Lese- und Schreibzugriff auflisten

Verwenden des Azure-Portals:

  1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

  2. Wählen Sie im Ressourcenmenü unter dem Abschnitt Einstellungen die Option Serverparameter und wählen Sie dann Statisch aus. Auf dieser Seite wird eine Liste von Schreib- und Leseparametern angezeigt, bei denen nach einer Änderung des Werts ein Neustart des Servers erforderlich ist, damit der neue Wert wirksam wird.

    Screenshot der statischen Serverparameter.

Dynamische Serverparameter mit Lese- und Schreibzugriff auflisten

Verwenden des Azure-Portals:

  1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

  2. Wählen Sie im Ressourcenmenü unter dem Abschnitt Einstellungen die Option Serverparameter und wählen Sie dann Dynamisch aus. Auf dieser Seite wird eine Liste von Schreib- und Leseparametern angezeigt, bei denen nach einer Änderung des Werts ein Neustart des Servers erforderlich ist, damit der neue Wert wirksam wird.

    Screenshot der dynamischen Serverparameter.

Schreibgeschützte Serverparameter auflisten

Verwenden des Azure-Portals:

  1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

  2. Wählen Sie im Ressourcenmenü unter dem Abschnitt Einstellungen die Option Serverparameter und wählen Sie dann Schreibgeschützt aus. Auf der Seite wird eine Liste schreibgeschützter Parameter angezeigt.

    Screenshot der schreibgeschützten Serverparameter.

Den Wert eines oder mehrerer Serverparameter festlegen

Verwenden des Azure-Portals:

  1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

  2. Wählen Sie im Ressourcenmenü unter dem Abschnitt Einstellungen die Option Serverparameter aus.

  3. Suchen Sie die Schreib-/Leseparameter, deren aktuelle Werte Sie ändern möchten, setzen Sie sie auf die neuen gewünschten Werte, beachten Sie, dass eine Informationsmeldung anzeigt, wie viele Serverparameteränderungen noch nicht gespeichert sind, und wählen Sie Speichern.

    Screenshot des Festlegens des Werts eines Serverparameters.

  4. Wenn die Spalte Parametertyp für einen der geänderten Parameter den Wert Statisch hat, muss der Server neu gestartet werden, damit die Änderungen wirksam werden. In diesem Fall wird ein Dialogfeld eingeblendet, in dem Sie auswählen können, ob Sie eine dieser Optionen verwenden möchten:

    • Speichern und neu starten: Wenn Sie alle Änderungen an allen Parametern, deren Werte geändert wurden, beibehalten wollen und sofort nach dem Neustart des Servers, damit die Änderungen an den statischen Parametern wirksam werden.
    • Nur speichern: Wenn Sie alle Änderungen an allen Parametern, deren Werte sich geändert haben, beibehalten, den Neustart des Servers aber auf einen späteren Zeitpunkt verschieben möchten. Solange Sie die Aktion zum Neustart des Servers nicht abgeschlossen haben, werden Änderungen an statischen Serverparametern nicht wirksam.
    • Abbrechen: Um noch keine Änderungen zu implementieren.

    Screenshot des Dialogfensters, das einen Neustart des Servers nach der Änderung eines statischen Parameters anfordert.

Einen Serverparameter auf die Standardeinstellung zurücksetzen

Verwenden des Azure-Portals:

  1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

  2. Wählen Sie im Ressourcenmenü unter dem Abschnitt Einstellungen die Option Serverparameter aus.

  3. Suchen Sie den Schreib-/Leseparameter, dessen aktuellen Wert Sie auf den Standardwert zurücksetzen möchten, klicken Sie auf die Ellipse am rechten Ende des Bildschirms und wählen Sie Auf Standartwert zurücksetzen.

    Screenshot des Zurücksetzens des Wertes eines Serverparameters auf seinen Standardwert.

Wichtig

Bei Parametern, die als schreibgeschützt gekennzeichnet sind, wird bei Auswahl der Auslassungspunkte nicht die Menüoption Auf Standard zurücksetzen angezeigt.

  1. Wenn die Spalte Parametertyp für den Parameter, dessen Wert Sie zurücksetzen möchten, den Wert Statisch hat, muss der Server neu gestartet werden, damit die Änderungen wirksam werden. In diesem Fall wird ein Dialogfeld eingeblendet, in dem Sie auswählen können, ob Sie eine dieser Optionen verwenden möchten:

    • Speichern und neu starten: Wenn Sie alle Änderungen an allen Parametern, deren Werte geändert wurden, beibehalten wollen und sofort nach dem Neustart des Servers, damit die Änderungen an den statischen Parametern wirksam werden.
    • Nur speichern: Wenn Sie alle Änderungen an allen Parametern, deren Werte sich geändert haben, beibehalten, den Neustart des Servers aber auf einen späteren Zeitpunkt verschieben möchten. Solange Sie die Aktion zum Neustart des Servers nicht abgeschlossen haben, werden Änderungen an statischen Serverparametern nicht wirksam.
    • Abbrechen: Um noch keine Änderungen zu implementieren.

    Screenshot des Dialogfensters, das einen Neustart des Servers nach der Änderung des Wertes eines statischen Parameters anfordert.

Alle Serverparameter auf ihre Standardwerte zurücksetzen

Verwenden des Azure-Portals:

  1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

  2. Wählen Sie im Ressourcenmenü unter dem Abschnitt Einstellungen die Option Serverparameter aus.

  3. Wählen Sie Alle auf Standard zurücksetzen.

    Screenshot des Zurücksetzens des Wertes aller Serverparameter auf ihre Standardwerte.

  4. Wenn für einen der Parameter, deren aktueller Wert nicht mit dem Standardwert übereinstimmt, in der Spalte Parametertyp der Wert Statisch angegeben ist, muss der Server neu gestartet werden, damit die Änderung wirksam wird. In diesem Fall wird ein Dialogfeld eingeblendet, in dem Sie auswählen können, ob Sie eine dieser Optionen verwenden möchten:

    • Speichern und neu starten: Wenn Sie alle Änderungen an allen Parametern, deren Werte geändert wurden, beibehalten wollen und sofort nach dem Neustart des Servers, damit die Änderungen an den statischen Parametern wirksam werden.
    • Nur speichern: Wenn Sie alle Änderungen an allen Parametern, deren Werte sich geändert haben, beibehalten, den Neustart des Servers aber auf einen späteren Zeitpunkt verschieben möchten. Solange Sie die Aktion zum Neustart des Servers nicht abgeschlossen haben, werden Änderungen an statischen Serverparametern nicht wirksam.
    • Abbrechen: Um noch keine Änderungen zu implementieren.

    Screenshot des Dialogfensters, das einen Neustart des Servers anfordert, nachdem alles auf die Standardeinstellungen zurückgesetzt wurde.

Verwenden von Zeitzonenparametern

Wenn Sie mit Datums- und Uhrzeitdaten in PostgreSQL arbeiten möchten, achten Sie darauf, dass Sie die richtige Zeitzone für Ihren Standort festgelegt haben. Alle zeitzonenspezifischen Datums- und Uhrzeitangaben werden intern in PostgresSQL im UTC-Format gespeichert. Sie werden in die durch den Parameter TimeZone angegebene Ortszeit der Zone konvertiert, bevor sie dem Client angezeigt werden. Dieser Parameter kann auf der Seite Serverparameter bearbeitet werden. PostgreSQL ermöglicht die Angabe von Zeitzonen in drei verschiedenen Formaten:

  • Ein vollständiger Zeitzonenname (beispielsweise „America/New_York“). Die zulässigen Zeitzonennamen sind in der Ansicht pg_timezone_names aufgeführt.
    Beispiel zum Abfragen dieser Ansicht in psql und zum Abrufen der Liste mit den Zeitzonennamen:

    select name FROM pg_timezone_names LIMIT 20;

    Das Resultset sollte in etwa wie folgt aussehen:

              name
      -----------------------
      GMT0
      Iceland
      Factory
      NZ-CHAT
      America/Panama
      America/Fort_Nelson
      America/Pangnirtung
      America/Belem
      America/Coral_Harbour
      America/Guayaquil
      America/Marigot
      America/Barbados
      America/Porto_Velho
      America/Bogota
      America/Menominee
      America/Martinique
      America/Asuncion
      America/Toronto
      America/Tortola
      America/Managua
      (20 rows)

  • Eine Zeitzonenabkürzung (beispielsweise PST). Durch eine solche Angabe wird lediglich ein bestimmter UTC-Versatz definiert. Vollständige Zeitzonennamen können dagegen auch eine Reihe von Regeln für das Sommerzeit-Übergangsdatum implizieren. Die zulässigen Abkürzungen sind in der Ansicht pg_timezone_abbrevs aufgeführt. Beispiel zum Abfragen dieser Ansicht in psql und zum Abrufen der Liste mit den Zeitzonenabkürzungen:

     select abbrev from pg_timezone_abbrevs limit 20;

    Das Resultset sollte in etwa wie folgt aussehen:

          abbrev|
      ------+
      ACDT  |
      ACSST |
      ACST  |
      ACT   |
      ACWST |
      ADT   |
      AEDT  |
      AESST |
      AEST  |
      AFT   |
      AKDT  |
      AKST  |
      ALMST |
      ALMT  |
      AMST  |
      AMT   |
      ANAST |
      ANAT  |
      ARST  |
      ART   |

  • Neben den Zeitzonennamen und -abkürzungen akzeptiert PostgreSQL POSIX-Zeitzonenangaben im Format „STDoffset“ oder „STDoffsetDST“. Dabei ist „STD“ eine Zonenabkürzung, „offset“ ein numerischer Versatz in Stunden westlich von UTC und „DST“ eine optionale Abkürzung für die Sommerzeitzone (steht für eine Stunde später als der angegebene Versatz).

Teilen Sie Ihre Vorschläge und Fehler mit dem Azure Database for PostgreSQL-Produktteam.