PostgreSQL için Azure Veritabanı'nda Azure Depolama uzantısı tarafından sağlanan işlevlerin başvurusu

Aşağıda Azure Depolama uzantısı tarafından sağlanan işlevlerin listesi verilmiştir:

azure_storage.account_add

Uzantının erişebileceği depolama hesapları listesine bir depolama hesabı ve ilişkili erişim anahtarı eklemeye azure_storage olanak tanıyan 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, 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 parametreyi kabul eden aşırı yüklenmiş bir account_config sürümü vardır.

azure_storage.account_add(account_config jsonb);

İzinler

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

Tartışmalar

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şilebilen 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çirilmesi 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şlevlerinin kullanılmasını öneririz.

Dönüş türü

VOID

azure_storage.account_options_managed_identity

azure_storage.account_add içinde parametre olarak çağrılabilen bir yardımcı program işlevi işlevi gören ve Azure Depolama hesabıyla etkileşime geçmek için sistem tarafından atanan yönetilen kimlik kullanılırken bağımsız değişken için geçerli bir değer üretmek için account_config yararlı olan işlev.

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

İzinler

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

Tartışmalar

isim

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şilebilen benzersiz bir ad alanı sağlar.

tür

azure_storage.storage_type desteklenen depolama türlerinden birinin değeri. Yalnızca desteklenen değer olur blob.

Dönüş türü

jsonb

azure_storage.account_options_credentials

azure_storage.account_add içinde parametre olarak çağrılabilen bir yardımcı program işlevi işlevi gören ve Azure Depolama hesabıyla etkileşime geçmek için bir Azure Depolama erişim anahtarı kullanırken bağımsız değişken için geçerli bir değer üretmek için account_config yararlı olan işlev.

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

İzinler

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

Tartışmalar

isim

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şilebilen benzersiz bir ad alanı sağlar.

kimlik bilgileri

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.

tür

azure_storage.storage_type desteklenen depolama türlerinden birinin değeri. Yalnızca desteklenen değer olur blob.

Dönüş türü

jsonb

azure_storage.account_options

azure_storage.account_add içinde parametre olarak çağrılabilen bir yardımcı program işlevi işlevi gören ve Azure Depolama hesabıyla etkileşime geçmek için Bir Azure Depolama erişim anahtarı veya sistem tarafından atanan yönetilen kimlik kullanılırken bağımsız değişken için geçerli bir değer üretmek için account_config yararlıdır.

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

İzinler

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

Tartışmalar

isim

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şilebilen benzersiz bir ad alanı sağlar.

auth_type

azure_storage.auth_type desteklenen depolama türlerinden birinin değeri. Yalnızca desteklenen değerler ve access-key'tirmanaged-identity.

storage_type

azure_storage.storage_type desteklenen depolama türlerinden birinin değeri. Yalnızca desteklenen değer olur blob.

kimlik bilgileri

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ırmaya azure_storage olanak tanıyan işlev.

azure_storage.account_remove(account_name_p text);

İzinler

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

Tartışmalar

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şilebilen 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 rol hesabına depolama hesabına erişim izni veren işlev.

Uyarı

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

azure_storage.account_add(account_name_p text, user_p regrole);

İzinler

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

Tartışmalar

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şilebilen 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 azure_storage sağlanan işlevler aracılığıyla bir PostgreSQL kullanıcısının veya rol erişiminin iptal edilmesini sağlayan işlev.

Uyarı

Bu işlevin yürütülmesi yalnızca adı ilk bağımsız değişken olarak geçirilen depolama hesabı azure_storage.account_add kullanılarak oluşturulmuşsa ve adı ikinci bağımsız değişken olarak geçirilen kullanıcı veya rol hala mevcutsa başarılı olur. Bir kullanıcı veya rol sunucudan bırakıldığında, yürütülerek DROP USER | ROLEAzure Depolama hesaplarına yapılan herhangi bir başvuruda verilen izinler de otomatik olarak ortadan kalkar.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

İzinler

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

Tartışmalar

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şilebilen 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ırılan depolama hesaplarının adlarını, uzantı tarafından azure_storage sağlanan işlevler aracılığıyla bu depolama hesabıyla etkileşim kurma izni verilen PostgreSQL kullanıcılarıyla veya rolleriyle birlikte listeleyen işlev.

azure_storage.account_list();

İzinler

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

Tartışmalar

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[]) Azure Depolama hesaplarının listesinin eklendiği dört sütunlu bir tablo, her hesapla etkileşim için kullanılan kimlik doğrulama türü, depolama alanı türü ve buna erişim izni verilen PostgreSQL kullanıcılarının veya rollerinin listesi.

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

İzinler

Bu işlevi çağıran kullanıcı veya rol, account_name yürütülerek başvuruda bulunulanın izin verilenler listesine eklenmelidir. azure_storage_admin üyelerinin başvuruları azure_storage.account_add kullanılarak eklenen tüm Azure Depolama hesaplarına otomatik olarak başvurmasına izin verilir.

Tartışmalar

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şilebilen 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 kurallara uyduğundan emin olun.

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

önek

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.

yol

text blobun tam adı.

byte

bigint blobun bayt cinsinden boyutu.

last_modified

timestamp with time zoneblob'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.

ETİKET

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 bilgi belirtildiğinde, depolama hizmeti sağlanan karmayı içerikten hesaplanan bir karmayla denetler. İki karma eşleşmezse, işlem 400 (Hatalı İstek) hata koduyla başarısız olur.

azure_storage.blob_get

Verilerin içeri aktarılmasına izin veren işlev. Azure Depolama hesabındaki bir blob kapsayıcısından dosya indirir. Ardından, içeriği SQL dil yapıları ile kullanılabilen ve işlenebilen 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çirilen 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. Bunlardan biri geçersizse bir hata oluşur.

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 çıkış biçimi kaydını rahatça tanımlamanızı sağlayan bir parametreyi kabul eden aşırı yüklenmiş bir rec sürümü vardır.

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

İzinler

Bu işlevi çağıran kullanıcı veya rol, account_name yürütülerek başvuruda bulunulanın izin verilenler listesine eklenmelidir. azure_storage_admin üyelerinin başvuruları azure_storage.account_add kullanılarak eklenen tüm Azure Depolama hesaplarına otomatik olarak başvurmasına izin verilir.

Tartışmalar

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şilebilen 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 kurallara uyduğundan emin olun.

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

yol

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 ayarlanabilir:

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.

sıkıştırma

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

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ı kullanmaya zorlar. 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ı kullanmaya zorlar. Yalnızca kodlayıcı tarafından parquet desteklenir.
none		Blobu sıkıştırmamaya zorlar.
snappy		Blobu sıkıştırmak için snappy sıkıştırma algoritmasını kullanmaya zorlar. Yalnızca kodlayıcı tarafından parquet desteklenir.
zstd		Zstd sıkıştırma algoritmasını kullanarak blobu sıkıştırmaya zorlar. Yalnızca kodlayıcı tarafından parquet desteklenir.

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

Seçenekler

jsonb özel üst bilgilerin, özel ayırıcıların, kaçış karakterlerinin vb. 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ı aktarmaya olanak tanıyan işlev. Dosyaların içeriği PostgreSQL'deki satırlardan oluşturulur.

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çirilen 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. Bunlardan biri geçersizse bir hata oluşur.

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ü vardır ve parametrenin uzantısından encoder çıkarılamadığında veya çıkarılmış olanı geçersiz kılmak istediğinizde kullanılacak kodlayıcıyı belirtmenize olanak tanıyan bir parametre içerirpath.

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

İşlevin, parametresinin uzantısından compression çıkarılmadığında veya çıkarılanı geçersiz kılmak istediğinizde kullanılacak sıkıştırmayı belirtmenize olanak tanıyan bir path parametre de içeren aşırı yüklenmiş bir sürümü vardır.

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

İşlevin özel üst bilgileri, özel ayırıcıları, kaçış karakterlerini vb. işlemek için bir parametre içeren aşırı yüklenmiş bir options sürümü vardır. options PostgreSQL'deki komuta geçirilebilen 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;

İzinler

Bu işlevi çağıran kullanıcı veya rol, account_name yürütülerek başvuruda bulunulanın izin verilenler listesine eklenmelidir. azure_storage_admin üyelerinin başvuruları azure_storage.account_add kullanılarak eklenen tüm Azure Depolama hesaplarına otomatik olarak başvurmasına izin verilir.

Tartışmalar

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şilebilen 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 kurallara uyduğundan emin olun.

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

yol

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 ayarlanabilir:

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 .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.

sıkıştırma

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

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ı kullanmaya zorlar. 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ı kullanmaya zorlar. Yalnızca kodlayıcı tarafından parquet desteklenir.
none		Blobu sıkıştırmamaya zorlar.
snappy		Blobu sıkıştırmak için snappy sıkıştırma algoritmasını kullanmaya zorlar. Yalnızca kodlayıcı tarafından parquet desteklenir.
zstd		Zstd sıkıştırma algoritmasını kullanarak blobu sıkıştırmaya zorlar. Yalnızca kodlayıcı tarafından parquet desteklenir.

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

Seçenekler

jsonb özel üst bilgilerin, özel ayırıcıların, kaçış karakterlerinin vb. 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ğrılabilen bir yardımcı program işlevi işlevi gören işlev. 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);

İzinler

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

Tartışmalar

sınırlayıcı

text dosyadaki her satırdaki (satır) 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 hatayı geri bildirir.

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 bayrağını kullanarak dosyanın, dosyadaki her sütunun adlarını içeren bir üst bilgi satırı içerip içermediğini gösterir. Çıktıda, ilk satır tablodaki sütun adlarını içerir.

alıntı

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 hatayı geri bildirir.

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 hatayı geri bildirir.

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ştirmiyor. 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 null dizeyle eşleştirin( alıntılansa bile) ve bir 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ı. Seçenek atlanırsa geçerli istemci kodlaması kullanılır.

Dönüş türü

jsonb

azure_storage.options_parquet

içinde parametre blob_getolarak çağrılabilen ve bir parquet dosyasının içeriğinin kodunu çözmek için yararlı olan bir yardımcı program işlevi işlevi.

azure_storage.options_parquet();

İzinler

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

Tartışmalar

Dönüş türü

jsonb

azure_storage.options_csv_get

içinde parametre blob_getolarak çağrılabilen ve bir csv dosyasının içeriğinin kodunu çözmek için yararlı olan bir yardımcı program işlevi işlevi.

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

İzinler

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

Tartışmalar

sınırlayıcı

text dosyadaki her satırdaki (satır) 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 hatayı geri bildirir.

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 bayrağını kullanarak dosyanın, dosyadaki her sütunun adlarını içeren bir üst bilgi satırı içerip içermediğini gösterir. Çıktıda, ilk satır tablodaki sütun adlarını içerir.

alıntı

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 hatayı geri bildirir.

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 hatayı geri bildirir.

force_not_null

text[] belirtilen sütunların değerlerini null dizeyle eşleştirmiyor. 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 null dizeyle eşleştirin( alıntılansa bile) ve bir 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ı. Seçenek atlanırsa geçerli istemci kodlaması kullanılır.

Dönüş türü

jsonb

azure_storage.options_tsv

içinde parametre blob_getolarak çağrılabilen bir yardımcı program işlevi işlevi gören ve tsv dosyasının içeriğinin kodunu çözmek için yararlı olan işlev.

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

İzinler

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

Tartışmalar

sınırlayıcı

text dosyadaki her satırdaki (satır) 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 hatayı geri bildirir.

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ı. Seçenek atlanırsa geçerli istemci kodlaması kullanılır.

Dönüş türü

jsonb

azure_storage.options_binary

içinde parametre blob_getolarak çağrılabilen bir yardımcı program işlevi işlevi gören ve ikili dosyanın içeriğinin kodunu çözmek için yararlı olan işlev.

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

İzinler

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

Tartışmalar

content_encoding

text dosyanın kodlandığı kodlamanın adı. Seçenek atlanırsa geçerli istemci kodlaması kullanılır.

Dönüş türü

jsonb

İlgili içerik

• Azure Depolama uzantısı.
• Azure Depolama uzantısını yapılandırın.
• Hızlı başlangıç örnekleri.
• Hataları giderin.
• Uzantılar ve modüller.