esnek PostgreSQL için Azure Veri Tabanı sunucuda Azure Depolama uzantısı tarafından sağlanan işlevlerin başvurusu

Aşağıdaki listede, Azure Depolama uzantısı tarafından sağlanan işlevler gösterilir:

azure_storage.account_add

Uzantının erişebileceği depolama hesapları listesine bir depolama hesabı ve ilişkili erişim anahtarı ekleyen azure_storage işlev.

Bu işlevin önceki bir çağrısı bu depolama hesabına başvuruyu zaten eklemişse, yeni bir giriş eklemez, bunun yerine var olan girişin erişim anahtarını güncelleştirir.

Uyarı

Bu işlev, başvurulan hesap adının mevcut olup olmadığını veya sağlanan erişim anahtarıyla erişilebilir olup olmadığını doğrulamaz. Ancak, Azure depolama hesaplarına uygulanan adlandırma doğrulama kurallarına göre depolama hesabının adının geçerli olduğunu doğrular.

azure_storage.account_add(account_name_p text, account_key_p text);

Bu işlevin aşırı yüklenmiş bir sürümü, başvurulan Azure Depolama hesabının adını ve kimlik doğrulama türü, hesap türü veya depolama kimlik bilgileri gibi tüm gerekli ayarları kapsülleyen bir account_config parametreyi kabul eder.

azure_storage.account_add(account_config jsonb);

Permissions

öğesinin azure_storage_adminüyesi olmalıdır.

Arguments

account_name_p

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

account_key_p

text depolama hesabının erişim anahtarlarından birinin değeri. Azure blob depolama erişim anahtarlarınız, depolama hesabınızın kök parolasına benzer. Erişim anahtarlarınızı korumak için her zaman dikkatli olun. Anahtarlarınızı güvenli bir şekilde yönetmek ve döndürmek için Azure Key Vault'ı kullanın. Hesap anahtarı, yalnızca süper kullanıcı tarafından erişilebilen bir tabloda depolanır. Rolü verilen azure_storage_admin kullanıcılar işlevler aracılığıyla bu tabloyla etkileşime geçebilir. Hangi depolama hesaplarının eklendiğini görmek için azure_storage.account_list işlevini kullanın.

account_config

jsonb Azure Depolama hesabının adı ve kimlik doğrulama türü, hesap türü veya depolama kimlik bilgileri gibi tüm gerekli ayarlar. Bu bağımsız değişken olarak geçirmeniz gereken geçerli değerlerden herhangi birini oluşturmak için azure_storage.account_options_managed_identity, azure_storage.account_options_credentials veya azure_storage.account_options yardımcı programı işlevlerini kullanın.

Dönüş türü

VOID

azure_storage.account_encrypt_existing_credentials

Uzantının eski sürümlerinde azure_storage.account_add kullanarak eklediğiniz mevcut depolama hesaplarının listesini tarar. Bu sürümler şifrelenmemiş kimlik bilgilerini depolar. Bu işlev, içinde azure_storage.credential_encryption_keydepolanan anahtarı kullanarak tüm kimlik bilgilerini şifreler. değerinin azure_storage.credential_encryption_key kapsamı sunucu düzeyindedir. Bu nedenle, Azure Depolama uzantısını aynı sunucuda birden çok veritabanında oluşturursanız, aynı şifreleme anahtarı, depolandıkları veritabanından bağımsız olarak uzantı tarafından depolanan tüm hassas kimlik bilgilerini şifreler.

Important

Azure Depolama uzantısını aynı sunucunun birden çok veritabanında oluşturursanız, işlevi bu veritabanlarının azure_storage.account_encrypt_existing_credentials her birinde yürütmeniz gerekir.

azure_storage.account_encrypt_existing_credentials();

Permissions

öğesinin azure_storage_adminüyesi olmalıdır.

Arguments

Bu işlev herhangi bir bağımsız değişken almaz.

Dönüş türü

bigint İşlev yürütülmeden önce şifrelenmemiş olan ve artık içinde azure_storage.credential_encryption_keydepolanan anahtar kullanılarak şifrelenen mevcut depolama hesabı kimlik bilgilerinin sayısı.

azure_storage.account_options_managed_identity

Yardımcı program işlevi gören işlev. azure_storage.account_add içinde parametre olarak çağır. Azure Depolama hesabıyla etkileşim kurmak için sistem tarafından atanan yönetilen kimliği kullandığınızda bağımsız değişken için account_config geçerli bir değer oluşturmanıza yardımcı olur.

azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);

Permissions

Herhangi bir kullanıcı veya rol bu işlevi çağırabilir.

Arguments

name

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

type

azure_storage.storage_type desteklenen depolama türlerinden birinin değeri. Desteklenen değer: blob.

Dönüş türü

jsonb

azure_storage.account_options_credentials

azure_storage.account_add içinde parametre olarak çağırabileceğiniz yardımcı program işlevi. Azure Depolama hesabıyla etkileşim kurmak için bir Azure Depolama erişim anahtarı kullandığınızda bağımsız değişken için account_config geçerli bir değer oluşturmanıza yardımcı olur.

azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);

Permissions

Herhangi bir kullanıcı veya rol bu işlevi çağırabilir.

Arguments

name

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

credentials

text depolama hesabının erişim anahtarlarından birinin değeri. Azure blob depolama erişim anahtarlarınız, depolama hesabınızın kök parolasına benzer. Erişim anahtarlarınızı korumak için her zaman dikkatli olun. Anahtarlarınızı güvenli bir şekilde yönetmek ve döndürmek için Azure Key Vault'ı kullanın. Hesap anahtarı, yalnızca süper kullanıcı tarafından erişilebilen bir tabloda depolanır. Rolü verilen azure_storage_admin kullanıcılar işlevler aracılığıyla bu tabloyla etkileşime geçebilir. Hangi depolama hesaplarının eklendiğini görmek için azure_storage.account_list işlevini kullanın.

type

azure_storage.storage_type desteklenen depolama türlerinden birinin değeri. Desteklenen değer: blob.

Dönüş türü

jsonb

azure_storage.account_options

azure_storage.account_add içinde parametre olarak çağırabileceğiniz yardımcı program işlevi. Azure Depolama hesabıyla etkileşim kurmak için bir Azure Depolama erişim anahtarı veya sistem tarafından atanan yönetilen kimlik kullandığınızda bağımsız değişken için account_config geçerli bir değer oluşturmanıza yardımcı olur.

azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);

Permissions

Herhangi bir kullanıcı veya rol bu işlevi çağırabilir.

Arguments

name

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

auth_type

azure_storage.auth_type desteklenen depolama türlerinden birinin değeri. Desteklenen değerler access-key ve managed-identity.

storage_type

azure_storage.storage_type desteklenen depolama türlerinden birinin değeri. Desteklenen değer: blob.

credentials

text depolama hesabının erişim anahtarlarından birinin değeri. Azure blob depolama erişim anahtarlarınız, depolama hesabınızın kök parolasına benzer. Erişim anahtarlarınızı korumak için her zaman dikkatli olun. Anahtarlarınızı güvenli bir şekilde yönetmek ve döndürmek için Azure Key Vault'ı kullanın. Hesap anahtarı, yalnızca süper kullanıcı tarafından erişilebilen bir tabloda depolanır. Rolü verilen azure_storage_admin kullanıcılar işlevler aracılığıyla bu tabloyla etkileşime geçebilir. Hangi depolama hesaplarının eklendiğini görmek için azure_storage.account_list işlevini kullanın.

Dönüş türü

jsonb

azure_storage.account_remove

Uzantının erişebileceği depolama hesapları listesinden bir depolama hesabını ve ilişkili erişim anahtarını kaldıran azure_storage işlev.

azure_storage.account_remove(account_name_p text);

Permissions

öğesinin azure_storage_adminüyesi olmalıdır.

Arguments

account_name_p

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

Dönüş türü

VOID

azure_storage.account_user_add

Uzantı tarafından azure_storage sağlanan işlevler aracılığıyla bir PostgreSQL kullanıcısına veya bir depolama hesabına rol erişimi veren işlev.

Uyarı

Bu işlevin yürütülmesi yalnızca adını ilk bağımsız değişken olarak geçirdiğiniz depolama hesabı azure_storage.account_add kullanılarak oluşturulmuşsa ve adını ikinci bağımsız değişken olarak geçirdiğiniz kullanıcı veya rol zaten varsa başarılı olur.

azure_storage.account_add(account_name_p text, user_p regrole);

Permissions

öğesinin azure_storage_adminüyesi olmalıdır.

Arguments

account_name_p

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

user_p

regrole Sunucuda bulunan postgreSQL kullanıcısının veya rolünün adı.

Dönüş türü

VOID

azure_storage.account_user_remove

Uzantı tarafından sağlanan işlevler aracılığıyla bir PostgreSQL kullanıcısını veya depolama hesabına rol erişimini iptal eden azure_storage işlev.

Uyarı

Bu işlevin yürütülmesi ancak adını ilk bağımsız değişken olarak geçirdiğiniz depolama hesabı zaten varsa ve azure_storage.account_add kullanılarak oluşturulduysa başarılı olur. İkinci bağımsız değişken olarak adını geçirdiğiniz kullanıcı veya rol de bulunmalıdır. yürüterek DROP USER | ROLEsunucudan bir kullanıcı veya rol bıraktığınızda, Azure Depolama hesaplarına yapılan herhangi bir başvuruda verilen izinler de otomatik olarak kaldırılır.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

Permissions

öğesinin azure_storage_adminüyesi olmalıdır.

Arguments

account_name_p

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

user_p

regrole Sunucuda bulunan postgreSQL kullanıcısının veya rolünün adı.

Dönüş türü

VOID

azure_storage.account_list

azure_storage.account_add işlevi aracılığıyla yapılandırdığınız depolama hesaplarının adlarını ve uzantı tarafından azure_storage sağlanan işlevler aracılığıyla bu depolama hesabıyla etkileşim kurma izinlerine sahip PostgreSQL kullanıcılarını veya rollerini listeleyen işlev.

azure_storage.account_list();

Permissions

öğesinin azure_storage_adminüyesi olmalıdır.

Arguments

Bu işlev herhangi bir bağımsız değişken almaz.

Dönüş türü

TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[])eklenen Azure Depolama hesaplarının listesini, her hesapla etkileşim için kullanılan kimlik doğrulama türünü, depolama türünü ve buna erişimi olan PostgreSQL kullanıcılarının veya rollerinin listesini içeren dört sütunlu bir tablo.

azure_storage.blob_list

Başvurulan depolama hesabının belirtilen kapsayıcısında depolanan blobların adlarını ve diğer özelliklerini (boyut, lastModified, eTag, contentType, contentEncoding ve contentHash) listeleyen işlev.

azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);

Permissions

azure_storage.account_user_add dosyasını yürüterek bu işlevi çağıran kullanıcı veya rolü için izin verme listesine account_name ekleyin. azure_storage_admin üyelerinin başvuruları azure_storage.account_add kullanılarak eklenen tüm Azure Depolama hesaplarına başvurmasına otomatik olarak izin verilir.

Arguments

account_name

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

konteyner_adı

text kapsayıcının adı. Kapsayıcı, dosya sistemindeki bir dizine benzer şekilde bir dizi blobu düzenler. Depolama hesabı sınırsız sayıda kapsayıcı içerebilir ve kapsayıcı sınırsız sayıda blob depolayabilir. Kapsayıcı adı, kapsayıcıyı veya bloblarını ele almak için kullanılan benzersiz URI'nin bir parçasını oluşturacağı için geçerli bir Etki Alanı Adı Sistemi (DNS) adı olmalıdır. Kapsayıcıyı adlandırırken bu kuralları izleyin.

Kapsayıcının URI'si şuna benzer: https://myaccount.blob.core.windows.net/mycontainer

prefix

text belirtildiğinde işlev, adları bu parametrede sağlanan değerle başlayan blobları döndürür. Varsayılan olarak boş bir dizedir.

Dönüş türü

TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) blobun tam adı ve diğer bazı özellikler de dahil olmak üzere blob başına bir kaydı olan bir tablo döndürülür.

path

text blobun tam adı.

bytes

bigint blobun bayt cinsinden boyutu.

last_modified

timestamp with time zone blob'un son değiştirildiği tarih ve saat. Blobun meta verilerinin veya özelliklerinin güncelleştirilmiş olması da dahil olmak üzere blobu değiştiren tüm işlemler, blobun son değiştirme zamanını değiştirir.

etag

text ETag özelliği, güncelleştirmeler sırasında iyimser eşzamanlılık için kullanılır. Bir kaydın en son güncelleştirildiği zamanı depolayan Timestamp adlı başka bir özellik olduğundan bu bir zaman damgası değildir. Örneğin, bir varlığı yükler ve güncelleştirmek isterseniz, ETag'in şu anda depolanmış olanla eşleşmesi gerekir. Aynı öğeyi düzenleyen birden çok kullanıcınız varsa, onların birbirlerinin değişikliklerinin üzerine yazılmasını istemediğinizden, uygun ETag'in ayarlanması önemlidir.

content_type

text blob için belirtilen içerik türü. Varsayılan içerik türü şeklindedir application/octet-stream.

content_encoding

text Azure Depolama'nın tanımlamanıza izin verdiği bir blobun Content-Encoding özelliği. Sıkıştırılmış içerik için özelliğini Gzip olarak ayarlayabilirsiniz. Tarayıcı içeriğe eriştiğinde, içeriği otomatik olarak açar.

content_hash

text aktarım sırasında blobun bütünlüğünü doğrulamak için kullanılan karma. Bu üst bilgiyi belirttiğinizde, depolama hizmeti sağlanan karmayı içerikten hesaplandığı karmaya göre denetler. İki karma eşleşmezse, işlem başarısız olur ve hata kodu 400 (Hatalı İstek) döndürür.

azure_storage.blob_get

Azure Depolama hesabındaki bir blob kapsayıcısından dosya indirerek verileri içeri aktaran işlev. İçeriği, SQL dil yapılarını kullanarak kullanabileceğiniz ve işleyebileceğiniz satırlara çevirir. Bu işlev, blob kapsayıcısından getirilen verileri içeri aktarmadan önce filtreleme ve işleme desteği ekler.

Uyarı

Başvuruda bulunılan depolama hesabının kapsayıcısına erişmeye çalışmadan önce, bu işlev bağımsız değişken olarak geçirdiğiniz depolama hesabının ve kapsayıcının adlarının Azure depolama hesaplarına uygulanan adlandırma doğrulama kurallarına göre geçerli olup olmadığını denetler. Adlardan biri geçersizse işlev bir hata döndürür.

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);

Bu işlevin aşırı yüklenmiş bir sürümü, çıkış biçimi kaydını rahatça tanımlamak için kullanabileceğiniz bir rec parametreyi kabul eder.

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);

Permissions

azure_storage.account_user_add dosyasını yürüterek bu işlevi çağıran kullanıcı veya rolü için izin verme listesine account_name ekleyin. azure_storage_admin üyelerinin başvuruları azure_storage.account_add kullanılarak eklenen tüm Azure Depolama hesaplarına başvurmasına otomatik olarak izin verilir.

Arguments

account_name

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

konteyner_adı

text kapsayıcının adı. Kapsayıcı, dosya sistemindeki bir dizine benzer şekilde bir dizi blobu düzenler. Depolama hesabı sınırsız sayıda kapsayıcı içerebilir ve kapsayıcı sınırsız sayıda blob depolayabilir. Kapsayıcı adı, kapsayıcıyı veya bloblarını ele almak için kullanılan benzersiz URI'nin bir parçasını oluşturacağı için geçerli bir Etki Alanı Adı Sistemi (DNS) adı olmalıdır. Kapsayıcıyı adlandırırken bu kuralları izleyin.

Kapsayıcının URI'si şuna benzer: https://myaccount.blob.core.windows.net/mycontainer

path

text blobun tam adı.

Rec

anyelement kayıt çıkış yapısının tanımı.

Kod çözücü

text blob biçiminin belirtimi. Aşağıdaki değerlerden herhangi birine ayarlayın:

Biçim Varsayılan Açıklama
auto true Değeri blob adına atanan son karakter serisine göre çıkarır. Blob adı ile .parquetbitiyorsa, olarak kabul edilir parquet. veya .csvile .csv.gz biterse, varsayılırcsv. veya .tsvile .tsv.gz biterse, varsayılırtsv. , , .json, .json.gz, .xml, .xml.gzveya .txtile .txt.gzbiterse varsayılırtext.
binary İkili PostgreSQL COPY biçimi.
csv PostgreSQL COPY tarafından kullanılan virgülle ayrılmış değerler biçimi.
parquet Parquet biçimi.
text | xml | json Tek bir metin değeri içeren bir dosya.
tsv Sekmeyle ayrılmış değerler, varsayılan PostgreSQL COPY biçimi.
compression

text sıkıştırma türünün belirtimi. Aşağıdaki değerlerden herhangi birine ayarlayın:

Biçim Varsayılan Açıklama
auto true Değeri blob adına atanan son karakter serisine göre çıkarır. Blob adı ile .gzbitiyorsa, olarak kabul edilir gzip. Aksi takdirde, varsayılır none.
brotli Blobu sıkıştırmak için brotli sıkıştırma algoritmasını kullanır. Yalnızca kodlayıcı tarafından parquet desteklenir.
gzip Blobu sıkıştırmak için gzip sıkıştırma algoritmasını kullanmaya zorlar.
lz4 Blobu sıkıştırmak için lz4 sıkıştırma algoritmasını kullanır. parquet Kodlayıcı, bu algoritmayı destekleyen tek kodlayıcıdır.
none Blobu sıkıştırmaz.
snappy Blobu sıkıştırmak için hızlı sıkıştırma algoritmasını kullanır. parquet Kodlayıcı, bu algoritmayı destekleyen tek kodlayıcıdır.
zstd Blobu sıkıştırmak için zstd sıkıştırma algoritmasını kullanır. parquet Kodlayıcı, bu algoritmayı destekleyen tek kodlayıcıdır.

Uzantı diğer sıkıştırma türlerini desteklemez.

options

jsonb özel üst bilgilerin, özel ayırıcıların, kaçış karakterlerinin ve diğer seçeneklerin işlenmesini tanımlayan ayarlar. options bu işlevin davranışını, PostgreSQL'deki komuta geçirebileceğiniz seçeneklerin COPY davranışını nasıl etkilediğine benzer şekilde etkiler.

Dönüş türü

SETOF record SETOF anyelement

azure_storage.blob_put

Azure Depolama hesabındaki bir blob kapsayıcısına dosya yükleyerek verileri dışarı aktaran işlev. İşlev, PostgreSQL'deki satırlardan dosya içeriğini oluşturur.

Uyarı

Başvuruda bulunılan depolama hesabının kapsayıcısına erişmeye çalışmadan önce, bu işlev bağımsız değişken olarak geçirdiğiniz depolama hesabının ve kapsayıcının adlarının Azure depolama hesaplarına uygulanan adlandırma doğrulama kurallarına göre geçerli olup olmadığını denetler. Adlardan biri geçersizse işlev bir hata döndürür.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;

İşlevin aşırı yüklenmiş bir sürümü parametresini encoder içerir. Kodlayıcıyı parametrenin uzantısından path çıkarılmadığında veya çıkarılacak kodlayıcıyı geçersiz kılmak istediğinizde belirtmek için bu parametreyi kullanın.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;

İşlevin aşırı yüklenmiş bir sürümü parametresini compression içerir. Bu parametreyi, parametrenin uzantısından path çıkarılmadığında veya çıkarım yapılan sıkıştırmayı geçersiz kılmak istediğinizde sıkıştırmayı belirtmek için kullanın.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;

İşlevin aşırı yüklenmiş bir sürümü, özel üst bilgileri, özel ayırıcıları, kaçış karakterlerini ve diğer seçenekleri işleme parametresini içerir options . parametresi, options PostgreSQL'deki komuta geçirebileceğiniz seçeneklere COPY benzer şekilde çalışır.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;

Permissions

azure_storage.account_user_add dosyasını yürüterek bu işlevi çağıran kullanıcı veya rolü için izin verme listesine account_name ekleyin. azure_storage_admin üyelerinin başvuruları azure_storage.account_add kullanılarak eklenen tüm Azure Depolama hesaplarına başvurmasına otomatik olarak izin verilir.

Arguments

account_name

text tüm nesnelerinizi içeren Azure blob depolama hesabının adı: bloblar, dosyalar, kuyruklar ve tablolar. Depolama hesabı, HTTPS üzerinden dünyanın her yerinden erişebileceğiniz benzersiz bir ad alanı sağlar.

konteyner_adı

text kapsayıcının adı. Kapsayıcı, dosya sistemindeki bir dizine benzer şekilde bir dizi blobu düzenler. Depolama hesabı sınırsız sayıda kapsayıcı içerebilir ve kapsayıcı sınırsız sayıda blob depolayabilir. Kapsayıcı adı, kapsayıcıyı veya bloblarını ele almak için kullanılan benzersiz URI'nin bir parçasını oluşturacağı için geçerli bir Etki Alanı Adı Sistemi (DNS) adı olmalıdır. Kapsayıcıyı adlandırırken bu kuralları izleyin.

Kapsayıcının URI'si şuna benzer: https://myaccount.blob.core.windows.net/mycontainer

path

text blobun tam adı.

Tuple

record kayıt çıkış yapısının tanımı.

kodlayıcı

text blob biçiminin belirtimi. Aşağıdaki değerlerden herhangi birine ayarlayın:

Biçim Varsayılan Açıklama
auto true Değeri blob adına atanan son karakter serisine göre çıkarır. Blob adı veya .csvile .csv.gz bitiyorsa, varsayılırcsv. veya .tsv.gzile .tsv biterse, varsayılırtsv. , , .json.gz, .xml, .xml.gz, .txtveya .txt.gzile .jsonbitiyorsa, varsayılırtext.
binary İkili PostgreSQL COPY biçimi.
csv PostgreSQL COPY tarafından kullanılan virgülle ayrılmış değerler biçimi.
parquet Parquet biçimi.
text | xml | json Tek bir metin değeri içeren bir dosya.
tsv Sekmeyle ayrılmış değerler, varsayılan PostgreSQL COPY biçimi.
compression

text sıkıştırma türünün belirtimi. Aşağıdaki değerlerden herhangi birine ayarlayın:

Biçim Varsayılan Açıklama
auto true Değeri blob adına atanan son karakter serisine göre çıkarır. Blob adı ile .gzbitiyorsa, olarak kabul edilir gzip. Aksi takdirde, varsayılır none.
brotli Blobu sıkıştırmak için brotli sıkıştırma algoritmasını kullanır. Yalnızca kodlayıcı tarafından parquet desteklenir.
gzip Blobu sıkıştırmak için gzip sıkıştırma algoritmasını kullanmaya zorlar.
lz4 Blobu sıkıştırmak için lz4 sıkıştırma algoritmasını kullanır. parquet Kodlayıcı, bu algoritmayı destekleyen tek kodlayıcıdır.
none Blobu sıkıştırmaz.
snappy Blobu sıkıştırmak için hızlı sıkıştırma algoritmasını kullanır. parquet Kodlayıcı, bu algoritmayı destekleyen tek kodlayıcıdır.
zstd Blobu sıkıştırmak için zstd sıkıştırma algoritmasını kullanır. parquet Kodlayıcı, bu algoritmayı destekleyen tek kodlayıcıdır.

Uzantı diğer sıkıştırma türlerini desteklemez.

options

jsonb özel üst bilgilerin, özel ayırıcıların, kaçış karakterlerinin ve diğer seçeneklerin işlenmesini tanımlayan ayarlar. options bu işlevin davranışını, PostgreSQL'deki komuta geçirebileceğiniz seçeneklerin COPY davranışını nasıl etkilediğine benzer şekilde etkiler.

Dönüş türü

VOID

azure_storage.options_copy

içinde blob_getparametre olarak çağırabileceğiniz yardımcı program işlevi. options_parquet, options_csv_get, options_tsv ve options_binary yardımcı işlevi görür.

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);

Permissions

Herhangi bir kullanıcı veya rol bu işlevi çağırabilir.

Arguments

sınırlayıcı

text Dosyanın her satırı (satırı) içindeki sütunları ayıran karakter. Tek bir 1 baytlık karakter olmalıdır. Bu işlev herhangi bir sayıda karakterin sınırlayıcılarını desteklese de, tek bir 1 bayttan daha fazla karakter kullanmayı denerseniz PostgreSQL bir COPY delimiter must be a single one-byte character hata döndürür.

null_string

text Null değeri temsil eden dize. Varsayılan değer, metin biçiminde \N (ters eğik çizgi-N) ve CSV biçiminde tırnak içinde olmayan boş bir dizedir. Boş dizeleri boş dizelerden ayırmak istemediğiniz durumlarda metin biçiminde bile boş dizeyi tercih edebilirsiniz.

boolean Dosyanın, dosyadaki her sütunun adlarını içeren bir üst bilgi satırı içerip içermediğini gösteren bayrak. Çıktıda, ilk satır tablodaki sütun adlarını içerir.

teklif

text Bir veri değeri alıntılandığında kullanılacak alıntı karakteri. Varsayılan değer çift tırnaktır. Tek bir 1 baytlık karakter olmalıdır. Bu işlev herhangi bir sayıda karakterin sınırlayıcılarını desteklese de, tek bir 1 bayttan daha fazla karakter kullanmayı denerseniz PostgreSQL bir COPY quote must be a single one-byte character hata döndürür.

kaçmak

text QUOTE değeriyle eşleşen bir veri karakterinden önce görünmesi gereken karakter. Varsayılan değer, QUOTE değeriyle aynıdır (böylece alıntılama karakteri verilerde görünürse iki katına çıkar). Tek bir 1 baytlık karakter olmalıdır. Bu işlev herhangi bir sayıda karakterin sınırlayıcılarını desteklese de, tek bir 1 bayttan daha fazla karakter kullanmayı denerseniz PostgreSQL bir COPY escape must be a single one-byte character hata döndürür.

force_quote

text[] belirtilen her sütundaki NULL olmayan tüm değerler için alıntı yapmaya zorlar. NULL çıkış hiçbir zaman tırnak içinde değildir. * belirtilirse, null olmayan değerler tüm sütunlarda tırnak içine alınır.

force_not_null

text[] Belirtilen sütunların değerlerini null dizeyle eşleştirin. Null dizenin boş olduğu varsayılan durumda, boş değerlerin tırnak içinde yer almadığında bile null yerine sıfır uzunluklu dizeler olarak okunduğu anlamına gelir.

force_null

text[] Belirtilen sütunların değerlerini, tırnak içinde olsa bile null dizeyle eşleştirin. Eşleşme bulunursa değeri NULL olarak ayarlayın. Null dizenin boş olduğu varsayılan durumda, tırnak içine alınmış boş bir dizeyi NULL'a dönüştürür.

content_encoding

text Dosyanın kodlandığı kodlamanın adı. Bu seçeneği atlarsanız geçerli istemci kodlaması kullanılır.

Dönüş türü

jsonb

azure_storage.options_parquet

Parquet dosyasının içeriğinin kodunu çözmek için yardımcı program işlevi. parametresi olarak blob_getkullanın.

azure_storage.options_parquet();

Permissions

Herhangi bir kullanıcı veya rol bu işlevi çağırabilir.

Arguments

Dönüş türü

jsonb

azure_storage.options_csv_get

CSV dosyasının içeriğinin kodunu çözmek için yardımcı program işlevi. Bu işlevi içinde blob_getbir parametre olarak çağır.

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);

Permissions

Herhangi bir kullanıcı veya rol bu işlevi çağırabilir.

Arguments

sınırlayıcı

text Dosyanın her satırı (satırı) içindeki sütunları ayıran karakter. Tek bir 1 baytlık karakter olmalıdır. Bu işlev herhangi bir sayıda karakterin sınırlayıcılarını desteklese de, tek bir 1 bayttan daha fazla karakter kullanmayı denerseniz PostgreSQL bir COPY delimiter must be a single one-byte character hata döndürür.

null_string

text Null değeri temsil eden dize. Varsayılan değer, metin biçiminde \N (ters eğik çizgi-N) ve CSV biçiminde tırnak içinde olmayan boş bir dizedir. Boş dizeleri boş dizelerden ayırmak istemediğiniz durumlarda metin biçiminde bile boş dizeyi tercih edebilirsiniz.

üstbilgi

boolean Dosyanın, dosyadaki her sütunun adlarını içeren bir üst bilgi satırı içerip içermediğini gösteren bayrak. Çıktıda, ilk satır tablodaki sütun adlarını içerir.

teklif

text Bir veri değeri alıntılandığında kullanılacak alıntı karakteri. Varsayılan değer çift tırnaktır. Tek bir 1 baytlık karakter olmalıdır. Bu işlev herhangi bir sayıda karakterin sınırlayıcılarını desteklese de, tek bir 1 bayttan daha fazla karakter kullanmayı denerseniz PostgreSQL bir COPY quote must be a single one-byte character hata döndürür.

kaçmak

text QUOTE değeriyle eşleşen bir veri karakterinden önce görünmesi gereken karakter. Varsayılan değer, QUOTE değeriyle aynıdır (böylece alıntılama karakteri verilerde görünürse iki katına çıkar). Tek bir 1 baytlık karakter olmalıdır. Bu işlev herhangi bir sayıda karakterin sınırlayıcılarını desteklese de, tek bir 1 bayttan daha fazla karakter kullanmayı denerseniz PostgreSQL bir COPY escape must be a single one-byte character hata döndürür.

force_not_null

text[] Belirtilen sütunların değerlerini null dizeyle eşleştirin. Null dizenin boş olduğu varsayılan durumda, boş değerlerin tırnak içinde yer almadığında bile null yerine sıfır uzunluklu dizeler olarak okunduğu anlamına gelir.

force_null

text[] Belirtilen sütunların değerlerini, tırnak içinde olsa bile null dizeyle eşleştirin. Eşleşme bulunursa değeri NULL olarak ayarlayın. Null dizenin boş olduğu varsayılan durumda, tırnak içine alınmış boş bir dizeyi NULL'a dönüştürür.

content_encoding

text Dosyanın kodlandığı kodlamanın adı. Bu seçeneği atlarsanız geçerli istemci kodlaması kullanılır.

Dönüş türü

jsonb

azure_storage.options_tsv

TSV dosyasının içeriğinin kodunu çözmek için yardımcı program işlevi. Bu işlevi içinde blob_getbir parametre olarak çağır.

azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);

Permissions

Herhangi bir kullanıcı veya rol bu işlevi çağırabilir.

Arguments

sınırlayıcı

text Dosyanın her satırı (satırı) içindeki sütunları ayıran karakter. Tek bir 1 baytlık karakter olmalıdır. Bu işlev herhangi bir sayıda karakterin sınırlayıcılarını desteklese de, tek bir 1 bayttan daha fazla karakter kullanmayı denerseniz PostgreSQL bir COPY delimiter must be a single one-byte character hata döndürür.

null_string

text Null değeri temsil eden dize. Varsayılan değer, metin biçiminde \N (ters eğik çizgi-N) ve CSV biçiminde tırnak içinde olmayan boş bir dizedir. Boş dizeleri boş dizelerden ayırmak istemediğiniz durumlarda metin biçiminde bile boş dizeyi tercih edebilirsiniz.

content_encoding

text Dosyanın kodlandığı kodlamanın adı. Bu seçeneği atlarsanız geçerli istemci kodlaması kullanılır.

Dönüş türü

jsonb

azure_storage.options_binary

içinde blob_getparametre olarak çağırabileceğiniz yardımcı program işlevi. İkili dosyanın içeriğinin kodunu çözmeye yardımcı olur.

azure_storage.options_binary(content_encoding text DEFAULT NULL::text);

Permissions

Herhangi bir kullanıcı veya rol bu işlevi çağırabilir.

Arguments

content_encoding

text Dosyanın kodlandığı kodlamanın adı. Bu seçeneği atlarsanız geçerli istemci kodlaması kullanılır.

Dönüş türü

jsonb