Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Es folgt die Liste der Funktionen, die von der Azure Storage-Erweiterung bereitgestellt werden:
azure_storage.account_add
Funktion, die das Hinzufügen eines Speicherkontos und des zugehörigen Zugriffsschlüssels zur Liste der Speicherkonten ermöglicht, auf die die azure_storage Erweiterung zugreifen kann.
Wenn ein vorheriger Aufruf dieser Funktion bereits den Verweis auf dieses Speicherkonto hinzugefügt hat, wird kein neuer Eintrag hinzugefügt, sondern stattdessen der Zugriffsschlüssel des vorhandenen Eintrags aktualisiert.
Hinweis
Diese Funktion überprüft nicht, ob der Name des verwiesenen Kontos vorhanden ist oder mit der bereitgestellten Zugriffstaste darauf zugegriffen werden kann. Es überprüft jedoch, ob der Name des Speicherkontos gültig ist, entsprechend den Benennungsüberprüfungsregeln, die für Azure-Speicherkonten auferlegt werden.
azure_storage.account_add(account_name_p text, account_key_p text);
Es gibt eine überladene Version dieser Funktion, die einen account_config Parameter akzeptiert, der den Namen des referenzierten Azure Storage-Kontos und alle erforderlichen Einstellungen wie Authentifizierungstyp, Kontotyp oder Speicheranmeldeinformationen kapselt.
azure_storage.account_add(account_config jsonb);
Erlaubnisse
Muss Mitglied von azure_storage_admin.
Argumente
account_name_p
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
account_key_p
text der Wert einer der Zugriffstasten für das Speicherkonto. Ihre Azure Blob Storage-Zugriffstasten ähneln einem Stammkennwort für Ihr Speicherkonto. Achten Sie darauf, die Zugriffsschlüssel immer gut zu schützen. Verwenden Sie Azure Key Vault zum sicheren Verwalten und Rotieren Ihrer Schlüssel. Der Kontoschlüssel wird in einer Tabelle gespeichert, auf die nur der Superuser zugreifen kann. Benutzer, die der azure_storage_admin Rolle erteilt wurden, können über Funktionen mit dieser Tabelle interagieren. Um festzustellen, welche Speicherkonten hinzugefügt werden, verwenden Sie die Funktion azure_storage.account_list.
account_config
jsonb der Name des Azure Storage-Kontos und alle erforderlichen Einstellungen wie Authentifizierungstyp, Kontotyp oder Speicheranmeldeinformationen. Wir empfehlen die Verwendung der Hilfsfunktionen azure_storage.account_options_managed_identity, azure_storage.account_options_credentials oder azure_storage.account_options , um einen der gültigen Werte zu erstellen, die als dieses Argument übergeben werden müssen.
Rückgabetyp
VOID
azure_storage.account_options_managed_identity
Funktion, die als Hilfsfunktion fungiert, die als Parameter innerhalb von azure_storage.account_add aufgerufen werden kann und nützlich ist, um einen gültigen Wert für das account_config Argument zu erzeugen, wenn ein System, dem verwaltete Identität zugewiesen ist, für die Interaktion mit dem Azure Storage-Konto verwendet wird.
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
Erlaubnisse
Jeder Benutzer oder jede Rolle kann diese Funktion aufrufen.
Argumente
Name
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
Typ
azure_storage.storage_type der Wert eines der unterstützten Speichertypen. Es wird blobnur ein unterstützter Wert angegeben.
Rückgabetyp
jsonb
azure_storage.account_options_credentials
Funktion, die als Hilfsfunktion fungiert, die als Parameter innerhalb von azure_storage.account_add aufgerufen werden kann und nützlich ist, um einen gültigen Wert für das account_config Argument zu erzeugen, wenn Sie einen Azure Storage-Zugriffsschlüssel für die Interaktion mit dem Azure Storage-Konto verwenden.
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
Erlaubnisse
Jeder Benutzer oder jede Rolle kann diese Funktion aufrufen.
Argumente
Name
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
Zugangsdaten
text der Wert einer der Zugriffstasten für das Speicherkonto. Ihre Azure Blob Storage-Zugriffstasten ähneln einem Stammkennwort für Ihr Speicherkonto. Achten Sie darauf, die Zugriffsschlüssel immer gut zu schützen. Verwenden Sie Azure Key Vault zum sicheren Verwalten und Rotieren Ihrer Schlüssel. Der Kontoschlüssel wird in einer Tabelle gespeichert, auf die nur der Superuser zugreifen kann. Benutzer, die der azure_storage_admin Rolle erteilt wurden, können über Funktionen mit dieser Tabelle interagieren. Um festzustellen, welche Speicherkonten hinzugefügt werden, verwenden Sie die Funktion azure_storage.account_list.
Typ
azure_storage.storage_type der Wert eines der unterstützten Speichertypen. Es wird blobnur ein unterstützter Wert angegeben.
Rückgabetyp
jsonb
azure_storage.account_options
Funktion, die als Hilfsfunktion fungiert, die als Parameter innerhalb von azure_storage.account_add aufgerufen werden kann und nützlich ist, um einen gültigen Wert für das account_config Argument zu erzeugen, wenn Sie einen Azure Storage-Zugriffsschlüssel oder eine vom System zugewiesene verwaltete Identität verwenden, um mit dem Azure Storage-Konto zu interagieren.
azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);
Erlaubnisse
Jeder Benutzer oder jede Rolle kann diese Funktion aufrufen.
Argumente
Name
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
auth_type
azure_storage.auth_type der Wert eines der unterstützten Speichertypen. Es werden access-keynur unterstützte Werte und managed-identity.
storage_type
azure_storage.storage_type der Wert eines der unterstützten Speichertypen. Es wird blobnur ein unterstützter Wert angegeben.
Zugangsdaten
text der Wert einer der Zugriffstasten für das Speicherkonto. Ihre Azure Blob Storage-Zugriffstasten ähneln einem Stammkennwort für Ihr Speicherkonto. Achten Sie darauf, die Zugriffsschlüssel immer gut zu schützen. Verwenden Sie Azure Key Vault zum sicheren Verwalten und Rotieren Ihrer Schlüssel. Der Kontoschlüssel wird in einer Tabelle gespeichert, auf die nur der Superuser zugreifen kann. Benutzer, die der azure_storage_admin Rolle erteilt wurden, können über Funktionen mit dieser Tabelle interagieren. Um festzustellen, welche Speicherkonten hinzugefügt werden, verwenden Sie die Funktion azure_storage.account_list.
Rückgabetyp
jsonb
azure_storage.account_remove
Funktion, die das Entfernen eines Speicherkontos und des zugehörigen Zugriffsschlüssels aus der Liste der Speicherkonten ermöglicht, auf die die azure_storage Erweiterung zugreifen kann.
azure_storage.account_remove(account_name_p text);
Erlaubnisse
Muss Mitglied von azure_storage_admin.
Argumente
account_name_p
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
Rückgabetyp
VOID
azure_storage.account_user_add
Funktion, die es ermöglicht, einem PostgreSQL-Benutzer oder einer Rolle Zugriff auf ein Speicherkonto über die von der azure_storage Erweiterung bereitgestellten Funktionen zu gewähren.
Hinweis
Die Ausführung dieser Funktion ist nur erfolgreich, wenn das Speicherkonto, dessen Name als erstes Argument übergeben wird, bereits mit azure_storage.account_add erstellt wurde und wenn der Benutzer oder die Rolle, deren Name als zweites Argument übergeben wird, bereits vorhanden ist.
azure_storage.account_add(account_name_p text, user_p regrole);
Erlaubnisse
Muss Mitglied von azure_storage_admin.
Argumente
account_name_p
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
user_p
regrole der Name eines PostgreSQL-Benutzers oder einer auf dem Server verfügbaren Rolle.
Rückgabetyp
VOID
azure_storage.account_user_remove
Funktion, die das Widerrufen eines PostgreSQL-Benutzers oder eines Rollenzugriffs auf ein Speicherkonto über die von der azure_storage Erweiterung bereitgestellten Funktionen ermöglicht.
Hinweis
Die Ausführung dieser Funktion ist nur erfolgreich, wenn das Speicherkonto, dessen Name als erstes Argument übergeben wird, bereits mit azure_storage.account_add erstellt wurde und wenn der Benutzer oder die Rolle, deren Name als zweites Argument übergeben wird, weiterhin vorhanden ist.
Wenn ein Benutzer oder eine Rolle vom Server gelöscht wird, werden DROP USER | ROLEdie Berechtigungen, die für einen Verweis auf Azure Storage-Konten erteilt wurden, ebenfalls automatisch entfernt.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
Erlaubnisse
Muss Mitglied von azure_storage_admin.
Argumente
account_name_p
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
user_p
regrole der Name eines PostgreSQL-Benutzers oder einer auf dem Server verfügbaren Rolle.
Rückgabetyp
VOID
azure_storage.account_list
Funktion, die die Namen der Speicherkonten auflistet, die über die Funktion azure_storage.account_add konfiguriert wurden, zusammen mit den PostgreSQL-Benutzern oder -Rollen, die Berechtigungen für die Interaktion mit diesem Speicherkonto über die von der azure_storage Erweiterung bereitgestellten Funktionen gewährt werden.
azure_storage.account_list();
Erlaubnisse
Muss Mitglied von azure_storage_admin.
Argumente
Diese Funktion verwendet keine Argumente.
Rückgabetyp
TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) eine vierspaltige Tabelle mit der Liste der hinzugefügten Azure Storage-Konten, die Art der Authentifizierung, die für die Interaktion mit jedem Konto, den Speichertyp und die Liste der PostgreSQL-Benutzer oder -Rollen verwendet wird, die Zugriff darauf gewährt werden.
azure_storage.blob_list
Funktion, die die Namen und andere Eigenschaften (Größe, lastModified, eTag, contentType, contentEncoding und contentHash) von Blobs auflistet, die im angegebenen Container des referenzierbaren Speicherkontos gespeichert sind.
azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);
Erlaubnisse
Der Benutzer oder die Rolle, die diese Funktion aufruft, muss der Liste zugelassener Benutzer oder Rollen hinzugefügt account_name werden, indem azure_storage.account_user_add ausgeführt wird. Mitglieder von azure_storage_admin sind automatisch berechtigt, auf alle Azure Storage-Konten zu verweisen, deren Verweise mithilfe von azure_storage.account_add hinzugefügt wurden.
Argumente
account_name
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
container_name
text der Name eines Containers. Ein Container organisiert eine Reihe von Blobs, ähnlich wie ein Verzeichnis in einem Dateisystem. Ein Speicherkonto kann eine unbegrenzte Anzahl von Containern enthalten, und ein Container kann eine unbegrenzte Anzahl von Blobs speichern.
Ein Containername muss ein gültiger DNS-Name (Domain Name System) sein, da er Teil des eindeutigen URI ist, der zum Adressieren des Containers oder seiner BLOBs verwendet wird.
Achten Sie beim Benennen eines Containers darauf, diese Regeln zu befolgen.
Der URI für einen Container ähnelt folgendem: https://myaccount.blob.core.windows.net/mycontainer
Präfix
text wenn angegeben, gibt die Funktion die Blobs zurück, deren Namen mit dem in diesem Parameter angegebenen Wert beginnen. Standardmäßig wird eine leere Zeichenfolge verwendet.
Rückgabetyp
TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) eine Tabelle mit einem Datensatz pro blob, der zurückgegeben wird, einschließlich des vollständigen Namens des Blobs und einiger anderer Eigenschaften.
Pfad
text den vollständigen Namen des Blobs.
Byte
bigint die Größe des Blobs in Byte.
last_modified
timestamp with time zoneDatum und Uhrzeit der letzten Änderung des Blobs. Durch jeden Vorgang, der das BLOB ändert, einschließlich eines Updates der Metadaten oder Eigenschaften des BLOB, wird die Uhrzeit der letzten Änderung aktualisiert.
etag
text Die ETag-Eigenschaft wird für optimistische Parallelität während Updates verwendet. Es handelt sich nicht um einen Zeitstempel, da eine andere Eigenschaft namens Timestamp vorhanden ist, die das letzte Mal speichert, wenn ein Datensatz aktualisiert wurde. Wenn Sie beispielsweise eine Entität laden und aktualisieren möchten, muss das ETag mit dem übereinstimmen, was derzeit gespeichert ist. Das Festlegen des entsprechenden ETags ist wichtig, da Sie bei mehreren Benutzern, die dasselbe Element bearbeiten, nicht möchten, dass sie die Änderungen gegenseitig überschreiben.
content_type
text der für das Blob angegebene Inhaltstyp. Der Standardinhaltstyp ist application/octet-stream.
content_encoding
text die Inhaltscodierungseigenschaft eines Blobs, mit dem Azure Storage definiert werden kann. Bei komprimierten Inhalten könnten Sie die Eigenschaft auf Gzip festlegen. Wenn der Browser auf den Inhalt zugreift, wird der Inhalt automatisch dekomprimiert.
content_hash
text der Hash, der verwendet wird, um die Integrität des Blobs während des Transports zu überprüfen. Wenn dieser Header angegeben ist, überprüft der Speicherdienst den bereitgestellten Hash mit einem vom Inhalt berechneten Hash. Wenn die beiden Hashes nicht übereinstimmen, schlägt der Vorgang mit dem Fehlercode 400 (Ungültige Anforderung) fehl.
azure_storage.blob_get
Funktion, die das Importieren von Daten zulässt. Sie lädt eine Datei aus einem BLOB-Container in ein Azure Storage-Konto herunter. Anschließend wird der Inhalt in Zeilen übersetzt, die mit SQL-Sprachkonstrukten verwendet und verarbeitet werden können. Diese Funktion bietet Unterstützung zum Filtern und Bearbeiten der daten, die aus dem Blobcontainer abgerufen wurden, bevor sie importiert werden.
Hinweis
Bevor Sie versuchen, auf den Container für das referenzierte Speicherkonto zuzugreifen, überprüft diese Funktion, ob die Namen des Speicherkontos und containers, die als Argumente übergeben werden, gemäß den Benennungsüberprüfungsregeln gültig sind, die für Azure-Speicherkonten gelten. Wenn eine der beiden ungültig ist, wird ein Fehler ausgelöst.
azure_storage.blob_get(account_name text, container_name text, path text, decoder text DEFAULT 'auto'::text, compression text DEFAULT 'auto'::text, options jsonb DEFAULT NULL::jsonb);
Es gibt eine überladene Version dieser Funktion, die einen rec Parameter akzeptiert, mit dem Sie den Ausgabeformatdatensatz bequem definieren können.
azure_storage.blob_get(account_name text, container_name text, path text, rec anyelement, decoder text DEFAULT 'auto'::text, compression text DEFAULT 'auto'::text, options jsonb DEFAULT NULL::jsonb);
Erlaubnisse
Der Benutzer oder die Rolle, die diese Funktion aufruft, muss der Liste zugelassener Benutzer oder Rollen hinzugefügt account_name werden, indem azure_storage.account_user_add ausgeführt wird. Mitglieder von azure_storage_admin sind automatisch berechtigt, auf alle Azure Storage-Konten zu verweisen, deren Verweise mithilfe von azure_storage.account_add hinzugefügt wurden.
Argumente
account_name
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
container_name
text der Name eines Containers. Ein Container organisiert eine Reihe von Blobs, ähnlich wie ein Verzeichnis in einem Dateisystem. Ein Speicherkonto kann eine unbegrenzte Anzahl von Containern enthalten, und ein Container kann eine unbegrenzte Anzahl von Blobs speichern.
Ein Containername muss ein gültiger DNS-Name (Domain Name System) sein, da er Teil des eindeutigen URI ist, der zum Adressieren des Containers oder seiner BLOBs verwendet wird.
Achten Sie beim Benennen eines Containers darauf, diese Regeln zu befolgen.
Der URI für einen Container ähnelt folgendem: https://myaccount.blob.core.windows.net/mycontainer
Pfad
text den vollständigen Namen des Blobs.
Rec
anyelement die Definition der Datensatzausgabestruktur.
Decoder
text die Spezifikation des BLOB-Formats. Kann auf einen der folgenden Werte festgelegt werden:
| Format | Vorgabe | Beschreibung |
|---|---|---|
auto |
true |
Leitet den Wert basierend auf der letzten Reihe von Zeichen ab, die dem Namen des Blobs zugewiesen sind. Wenn der Blobname mit .parquetendet, wird davon ausgegangen parquet. Wenn sie mit .csv oder .csv.gzendet, wird davon ausgegangen csv. Wenn sie mit .tsv oder .tsv.gzendet, wird davon ausgegangen tsv. Endet mit .json, , , .json.gz, .xml, .xml.gzoder .txt, wird davon ausgegangen.txt.gztext. |
binary |
Binary PostgreSQL COPY Format. | |
csv |
Kommagetrennte Werteformat, das von PostgreSQL COPY verwendet wird. | |
parquet |
Parkettformat. | |
text | xml | json |
Eine Datei, die einen einzelnen Textwert enthält. | |
tsv |
Tabstopptrennte Werte, das standardmäßige PostgreSQL COPY-Format. |
Kompression
text die Spezifikation des Komprimierungstyps. Kann auf einen der folgenden Werte festgelegt werden:
| Format | Vorgabe | Beschreibung |
|---|---|---|
auto |
true |
Leitet den Wert basierend auf der letzten Reihe von Zeichen ab, die dem Namen des Blobs zugewiesen sind. Wenn der Blobname mit .gzendet, wird davon ausgegangen gzip. Andernfalls wird davon ausgegangen none. |
brotli |
Erzwingt die Verwendung des Brotli-Komprimierungsalgorithmus zum Komprimieren des Blobs. Wird nur vom parquet Encoder unterstützt. |
|
gzip |
Erzwingt die Verwendung des Gzip-Komprimierungsalgorithmus zum Komprimieren des Blobs. | |
lz4 |
Erzwingt die Verwendung des lz4-Komprimierungsalgorithmus zum Komprimieren des Blobs. Wird nur vom parquet Encoder unterstützt. |
|
none |
Erzwingt, das Blob nicht zu komprimieren. | |
snappy |
Erzwingt die Verwendung des Snappy-Komprimierungsalgorithmus zum Komprimieren des Blobs. Wird nur vom parquet Encoder unterstützt. |
|
zstd |
Erzwingt die Verwendung des Zstd-Komprimierungsalgorithmus zum Komprimieren des Blobs. Wird nur vom parquet Encoder unterstützt. |
Die Erweiterung unterstützt keine anderen Komprimierungstypen.
Optionen
jsonb die Einstellungen, die die Behandlung von benutzerdefinierten Kopfzeilen, benutzerdefinierten Trennzeichen, Escapezeichen usw. definieren. options wirkt sich auf das Verhalten dieser Funktion auf eine ähnliche Weise aus wie die Optionen, die Sie an den COPY Befehl in PostgreSQL übergeben können, beeinflussen sein Verhalten.
Rückgabetyp
SETOF record
SETOF anyelement
azure_storage.blob_put
Funktion, die das Exportieren von Daten ermöglicht, indem Dateien in einen BLOB-Container in ein Azure Storage-Konto hochgeladen werden. Der Inhalt der Dateien wird aus Zeilen in PostgreSQL produziert.
Hinweis
Bevor Sie versuchen, auf den Container für das referenzierte Speicherkonto zuzugreifen, überprüft diese Funktion, ob die Namen des Speicherkontos und containers, die als Argumente übergeben werden, gemäß den Benennungsüberprüfungsregeln gültig sind, die für Azure-Speicherkonten gelten. Wenn eine der beiden ungültig ist, wird ein Fehler ausgelöst.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
Es gibt eine überladene Version der Funktion, die einen Parameter enthält encoder , mit dem Sie den zu verwendenden Encoder angeben können, wenn er nicht von der Erweiterung des path Parameters abgeleitet werden kann, oder wenn Sie die abgeleitete Funktion außer Kraft setzen möchten.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
Es gibt eine überladene Version der Funktion, die auch einen compression Parameter enthält, mit dem Sie die zu verwendende Komprimierung angeben können, wenn sie nicht von der Erweiterung des path Parameters abgeleitet werden kann, oder wenn Sie das abgeleitete Element überschreiben möchten.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
Es gibt eine überladene Version der Funktion, die auch einen options Parameter zum Behandeln von benutzerdefinierten Headern, benutzerdefinierten Trennzeichen, Escapezeichen usw. enthält, options funktioniert auf ähnliche Weise wie die Optionen, die an den COPY Befehl in PostgreSQL übergeben werden können.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;
Erlaubnisse
Der Benutzer oder die Rolle, die diese Funktion aufruft, muss der Liste zugelassener Benutzer oder Rollen hinzugefügt account_name werden, indem azure_storage.account_user_add ausgeführt wird. Mitglieder von azure_storage_admin sind automatisch berechtigt, auf alle Azure Storage-Konten zu verweisen, deren Verweise mithilfe von azure_storage.account_add hinzugefügt wurden.
Argumente
account_name
text der Name des Azure Blob Storage-Kontos, das alle Ihre Objekte enthält: Blobs, Dateien, Warteschlangen und Tabellen. Das Speicherkonto stellt einen eindeutigen Namespace bereit, auf den von überall aus über HTTPS zugegriffen werden kann.
container_name
text der Name eines Containers. Ein Container organisiert eine Reihe von Blobs, ähnlich wie ein Verzeichnis in einem Dateisystem. Ein Speicherkonto kann eine unbegrenzte Anzahl von Containern enthalten, und ein Container kann eine unbegrenzte Anzahl von Blobs speichern.
Ein Containername muss ein gültiger DNS-Name (Domain Name System) sein, da er Teil des eindeutigen URI ist, der zum Adressieren des Containers oder seiner BLOBs verwendet wird.
Achten Sie beim Benennen eines Containers darauf, diese Regeln zu befolgen.
Der URI für einen Container ähnelt folgendem: https://myaccount.blob.core.windows.net/mycontainer
Pfad
text den vollständigen Namen des Blobs.
Tupel
record die Definition der Datensatzausgabestruktur.
Encoder
text die Spezifikation des BLOB-Formats. Kann auf einen der folgenden Werte festgelegt werden:
| Format | Vorgabe | Beschreibung |
|---|---|---|
auto |
true |
Leitet den Wert basierend auf der letzten Reihe von Zeichen ab, die dem Namen des Blobs zugewiesen sind. Wenn der Blobname mit .csv oder .csv.gzendet, wird davon ausgegangen csv. Wenn sie mit .tsv oder .tsv.gzendet, wird davon ausgegangen tsv. Endet mit .json, , , .json.gz, .xml, .xml.gzoder .txt, wird davon ausgegangen.txt.gztext. |
binary |
Binary PostgreSQL COPY Format. | |
csv |
Kommagetrennte Werteformat, das von PostgreSQL COPY verwendet wird. | |
parquet |
Parkettformat. | |
text | xml | json |
Eine Datei, die einen einzelnen Textwert enthält. | |
tsv |
Tabstopptrennte Werte, das standardmäßige PostgreSQL COPY-Format. |
Kompression
text die Spezifikation des Komprimierungstyps. Kann auf einen der folgenden Werte festgelegt werden:
| Format | Vorgabe | Beschreibung |
|---|---|---|
auto |
true |
Leitet den Wert basierend auf der letzten Reihe von Zeichen ab, die dem Namen des Blobs zugewiesen sind. Wenn der Blobname mit .gzendet, wird davon ausgegangen gzip. Andernfalls wird davon ausgegangen none. |
brotli |
Erzwingt die Verwendung des Brotli-Komprimierungsalgorithmus zum Komprimieren des Blobs. Wird nur vom parquet Encoder unterstützt. |
|
gzip |
Erzwingt die Verwendung des Gzip-Komprimierungsalgorithmus zum Komprimieren des Blobs. | |
lz4 |
Erzwingt die Verwendung des lz4-Komprimierungsalgorithmus zum Komprimieren des Blobs. Wird nur vom parquet Encoder unterstützt. |
|
none |
Erzwingt, das Blob nicht zu komprimieren. | |
snappy |
Erzwingt die Verwendung des Snappy-Komprimierungsalgorithmus zum Komprimieren des Blobs. Wird nur vom parquet Encoder unterstützt. |
|
zstd |
Erzwingt die Verwendung des Zstd-Komprimierungsalgorithmus zum Komprimieren des Blobs. Wird nur vom parquet Encoder unterstützt. |
Die Erweiterung unterstützt keine anderen Komprimierungstypen.
Optionen
jsonb die Einstellungen, die die Behandlung von benutzerdefinierten Kopfzeilen, benutzerdefinierten Trennzeichen, Escapezeichen usw. definieren. options wirkt sich auf das Verhalten dieser Funktion auf eine ähnliche Weise aus wie die Optionen, die Sie an den COPY Befehl in PostgreSQL übergeben können, beeinflussen sein Verhalten.
Rückgabetyp
VOID
azure_storage.options_copy
Funktion, die als Hilfsfunktion fungiert, die als Parameter aufgerufen blob_getwerden kann. Sie fungiert als Hilfsfunktion für options_parquet, options_csv_get, options_tsv und options_binary.
azure_storage.options_copy(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_quote text[] DEFAULT NULL::text[], force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);
Erlaubnisse
Jeder Benutzer oder jede Rolle kann diese Funktion aufrufen.
Argumente
Trennzeichen
text das Zeichen, das Spalten innerhalb jeder Zeile (Zeile) der Datei trennt. Es muss ein einzelnes 1-Byte-Zeichen sein. Obwohl diese Funktion Trennzeichen einer beliebigen Anzahl von Zeichen unterstützt, meldet PostgreSQL einen COPY delimiter must be a single one-byte character Fehler zurück, wenn Sie versuchen, mehr als ein einzelnes 1-Byte-Zeichen zu verwenden.
null_string
text die Zeichenfolge, die einen Nullwert darstellt. Der Standardwert ist \N (umgekehrter Schrägstrich-N) im Textformat und eine nicht angehaltene leere Zeichenfolge im CSV-Format. Möglicherweise bevorzugen Sie eine leere Zeichenfolge auch im Textformat für Fälle, in denen Sie keine Nullen von leeren Zeichenfolgen unterscheiden möchten.
Überschrift
boolean flag that indicates if the file contains a header line with the names of each column in the file. Bei der Ausgabe enthält die erste Zeile die Spaltennamen aus der Tabelle.
Quote
text das an zitierte Zeichen, das verwendet werden soll, wenn ein Datenwert in Anzeichen gesetzt wird. Der Standardwert ist doppeltes Anführungszeichen. Es muss ein einzelnes 1-Byte-Zeichen sein. Obwohl diese Funktion Trennzeichen einer beliebigen Anzahl von Zeichen unterstützt, meldet PostgreSQL einen COPY quote must be a single one-byte character Fehler zurück, wenn Sie versuchen, mehr als ein einzelnes 1-Byte-Zeichen zu verwenden.
Escape
text das Zeichen, das vor einem Datenzeichen angezeigt werden soll, das dem QUOTE-Wert entspricht. Der Standardwert ist identisch mit dem QUOTE-Wert (sodass das Anführungszeichen verdoppelt wird, wenn es in den Daten angezeigt wird). Es muss ein einzelnes 1-Byte-Zeichen sein. Obwohl diese Funktion Trennzeichen einer beliebigen Anzahl von Zeichen unterstützt, meldet PostgreSQL einen COPY escape must be a single one-byte character Fehler zurück, wenn Sie versuchen, mehr als ein einzelnes 1-Byte-Zeichen zu verwenden.
force_quote
text[] erzwingt die Verwendung von Quoten für alle Nicht-NULL-Werte in jeder angegebenen Spalte. NULL-Ausgabe wird nie zitiert. Wenn * angegeben ist, werden nicht NULL-Werte in allen Spalten zitiert.
force_not_null
text[] Stimmen Sie nicht mit den Werten der angegebenen Spalten mit der NULL-Zeichenfolge überein. In dem Standardfall, in dem die NULL-Zeichenfolge leer ist, bedeutet dies, dass leere Werte als leere Zeichenfolgen anstelle von Nullen gelesen werden, auch wenn sie nicht an zitiert werden.
force_null
text[] entsprechen den Werten der angegebenen Spalten mit der NULL-Zeichenfolge, auch wenn eine Übereinstimmung gefunden wird, legen Sie den Wert auf NULL fest. In dem Standardfall, in dem die NULL-Zeichenfolge leer ist, konvertiert sie eine leere Zeichenfolge in NULL.
content_encoding
text Name der Codierung, mit der die Datei codiert ist. Wenn die Option nicht angegeben wird, wird die aktuelle Clientcodierung verwendet.
Rückgabetyp
jsonb
azure_storage.options_parkett
Funktion, die als Hilfsfunktion fungiert, die als Parameter aufgerufen blob_getwerden kann, und ist nützlich, um den Inhalt einer Parkettdatei zu decodieren.
azure_storage.options_parquet();
Erlaubnisse
Jeder Benutzer oder jede Rolle kann diese Funktion aufrufen.
Argumente
Rückgabetyp
jsonb
azure_storage.options_csv_get
Funktion, die als Hilfsfunktion fungiert, die als Parameter aufgerufen blob_getwerden kann, und ist nützlich zum Decodieren des Inhalts einer CSV-Datei.
azure_storage.options_csv_get(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);
Erlaubnisse
Jeder Benutzer oder jede Rolle kann diese Funktion aufrufen.
Argumente
Trennzeichen
text das Zeichen, das Spalten innerhalb jeder Zeile (Zeile) der Datei trennt. Es muss ein einzelnes 1-Byte-Zeichen sein. Obwohl diese Funktion Trennzeichen einer beliebigen Anzahl von Zeichen unterstützt, meldet PostgreSQL einen COPY delimiter must be a single one-byte character Fehler zurück, wenn Sie versuchen, mehr als ein einzelnes 1-Byte-Zeichen zu verwenden.
null_string
text die Zeichenfolge, die einen Nullwert darstellt. Der Standardwert ist \N (umgekehrter Schrägstrich-N) im Textformat und eine nicht angehaltene leere Zeichenfolge im CSV-Format. Möglicherweise bevorzugen Sie eine leere Zeichenfolge auch im Textformat für Fälle, in denen Sie keine Nullen von leeren Zeichenfolgen unterscheiden möchten.
Überschrift
boolean flag that indicates if the file contains a header line with the names of each column in the file. Bei der Ausgabe enthält die erste Zeile die Spaltennamen aus der Tabelle.
Quote
text das an zitierte Zeichen, das verwendet werden soll, wenn ein Datenwert in Anzeichen gesetzt wird. Der Standardwert ist doppeltes Anführungszeichen. Es muss ein einzelnes 1-Byte-Zeichen sein. Obwohl diese Funktion Trennzeichen einer beliebigen Anzahl von Zeichen unterstützt, meldet PostgreSQL einen COPY quote must be a single one-byte character Fehler zurück, wenn Sie versuchen, mehr als ein einzelnes 1-Byte-Zeichen zu verwenden.
Escape
text das Zeichen, das vor einem Datenzeichen angezeigt werden soll, das dem QUOTE-Wert entspricht. Der Standardwert ist identisch mit dem QUOTE-Wert (sodass das Anführungszeichen verdoppelt wird, wenn es in den Daten angezeigt wird). Es muss ein einzelnes 1-Byte-Zeichen sein. Obwohl diese Funktion Trennzeichen einer beliebigen Anzahl von Zeichen unterstützt, meldet PostgreSQL einen COPY escape must be a single one-byte character Fehler zurück, wenn Sie versuchen, mehr als ein einzelnes 1-Byte-Zeichen zu verwenden.
force_not_null
text[] Stimmen Sie nicht mit den Werten der angegebenen Spalten mit der NULL-Zeichenfolge überein. In dem Standardfall, in dem die NULL-Zeichenfolge leer ist, bedeutet dies, dass leere Werte als leere Zeichenfolgen anstelle von Nullen gelesen werden, auch wenn sie nicht an zitiert werden.
force_null
text[] entsprechen den Werten der angegebenen Spalten mit der NULL-Zeichenfolge, auch wenn eine Übereinstimmung gefunden wird, legen Sie den Wert auf NULL fest. In dem Standardfall, in dem die NULL-Zeichenfolge leer ist, konvertiert sie eine leere Zeichenfolge in NULL.
content_encoding
text Name der Codierung, mit der die Datei codiert ist. Wenn die Option nicht angegeben wird, wird die aktuelle Clientcodierung verwendet.
Rückgabetyp
jsonb
azure_storage.options_tsv
Funktion, die als Hilfsfunktion fungiert, die als Parameter innerhalb blob_getaufgerufen werden kann und zum Decodieren des Inhalts einer TSV-Datei nützlich ist.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
Erlaubnisse
Jeder Benutzer oder jede Rolle kann diese Funktion aufrufen.
Argumente
Trennzeichen
text das Zeichen, das Spalten innerhalb jeder Zeile (Zeile) der Datei trennt. Es muss ein einzelnes 1-Byte-Zeichen sein. Obwohl diese Funktion Trennzeichen einer beliebigen Anzahl von Zeichen unterstützt, meldet PostgreSQL einen COPY delimiter must be a single one-byte character Fehler zurück, wenn Sie versuchen, mehr als ein einzelnes 1-Byte-Zeichen zu verwenden.
null_string
text die Zeichenfolge, die einen Nullwert darstellt. Der Standardwert ist \N (umgekehrter Schrägstrich-N) im Textformat und eine nicht angehaltene leere Zeichenfolge im CSV-Format. Möglicherweise bevorzugen Sie eine leere Zeichenfolge auch im Textformat für Fälle, in denen Sie keine Nullen von leeren Zeichenfolgen unterscheiden möchten.
content_encoding
text Name der Codierung, mit der die Datei codiert ist. Wenn die Option nicht angegeben wird, wird die aktuelle Clientcodierung verwendet.
Rückgabetyp
jsonb
azure_storage.options_binary
Funktion, die als Hilfsfunktion fungiert, die als Parameter innerhalb blob_getaufgerufen werden kann und zum Decodieren des Inhalts einer Binärdatei nützlich ist.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
Erlaubnisse
Jeder Benutzer oder jede Rolle kann diese Funktion aufrufen.
Argumente
content_encoding
text Name der Codierung, mit der die Datei codiert ist. Wenn die Option nicht angegeben wird, wird die aktuelle Clientcodierung verwendet.
Rückgabetyp
jsonb