إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
فيما يلي قائمة الوظائف التي يوفرها ملحق Azure Storage:
azure_storage.account_add
الدالة التي تسمح بإضافة حساب تخزين ومفتاح الوصول المقترن به إلى قائمة حسابات التخزين التي يمكن للملحق azure_storage الوصول إليها.
إذا أضاف استدعاء سابق لهذه الدالة بالفعل المرجع إلى حساب التخزين هذا، فإنه لا يضيف إدخالا جديدا ولكنه يقوم بدلا من ذلك بتحديث مفتاح الوصول للإدخل الموجود.
ملاحظة
لا تتحقق هذه الدالة مما إذا كان اسم الحساب المشار إليه موجودا أو إذا كان يمكن الوصول إليه باستخدام مفتاح الوصول المتوفر. ومع ذلك، فإنه يتحقق من صحة اسم حساب التخزين، وفقا لقواعد التحقق من صحة التسمية المفروضة على حسابات تخزين Azure.
azure_storage.account_add(account_name_p text, account_key_p text);
هناك إصدار محمل بشكل زائد من هذه الدالة، والذي يقبل معلمة account_config تغلف اسم حساب Azure Storage المشار إليه، وجميع الإعدادات المطلوبة مثل نوع المصادقة أو نوع الحساب أو بيانات اعتماد التخزين.
azure_storage.account_add(account_config jsonb);
الأذونات
يجب أن يكون عضوا في azure_storage_admin.
الوسيطات
account_name_p
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
account_key_p
text قيمة أحد مفاتيح الوصول لحساب التخزين. مفاتيح الوصول إلى تخزين Azure blob مشابهة لكلمة مرور الجذر لحساب التخزين الخاص بك. كن حذرًا دائمًا لحماية مفاتيح الوصول خاصتك. استخدم Azure Key Vault لإدارة المفاتيح وتدويرها بأمان. يتم تخزين مفتاح الحساب في جدول يمكن الوصول إليه فقط من قبل المستخدم الفائق. يمكن للمستخدمين الذين تم منحهم azure_storage_admin الدور التفاعل مع هذا الجدول عبر الوظائف. لمعرفة حسابات التخزين التي تمت إضافتها، استخدم الدالة azure_storage.account_list.
account_config
jsonb اسم حساب Azure Storage وجميع الإعدادات المطلوبة مثل نوع المصادقة أو نوع الحساب أو بيانات اعتماد التخزين. نوصي باستخدام وظائف الأداة المساعدة azure_storage.account_options_managed_identity أو azure_storage.account_options_credentials أو azure_storage.account_options لإنشاء أي من القيم الصالحة التي يجب تمريرها كوسيطة.
نوع الإرجاع
VOID
azure_storage.account_options_managed_identity
الدالة التي تعمل كدالة أداة مساعدة، والتي يمكن استدعاؤها كمعلمة داخل azure_storage.account_add، وهي مفيدة لإنتاج قيمة صالحة للوسيطة account_config ، عند استخدام هوية مدارة معينة من قبل النظام للتفاعل مع حساب Azure Storage.
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
الأذونات
يمكن لأي مستخدم أو دور استدعاء هذه الدالة.
الوسيطات
اسم
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
نوع
azure_storage.storage_type قيمة أحد أنواع التخزين المدعومة. القيمة المدعومة فقط هي blob.
نوع الإرجاع
jsonb
azure_storage.account_options_credentials
الدالة التي تعمل كدالة أداة مساعدة، والتي يمكن استدعاؤها كمعلمة داخل azure_storage.account_add، وهي مفيدة لإنتاج قيمة صالحة للوسيطة account_config ، عند استخدام مفتاح وصول Azure Storage للتفاعل مع حساب Azure Storage.
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
الأذونات
يمكن لأي مستخدم أو دور استدعاء هذه الدالة.
الوسيطات
اسم
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
وثائق التفويض
text قيمة أحد مفاتيح الوصول لحساب التخزين. مفاتيح الوصول إلى تخزين Azure blob مشابهة لكلمة مرور الجذر لحساب التخزين الخاص بك. كن حذرًا دائمًا لحماية مفاتيح الوصول خاصتك. استخدم Azure Key Vault لإدارة المفاتيح وتدويرها بأمان. يتم تخزين مفتاح الحساب في جدول يمكن الوصول إليه فقط من قبل المستخدم الفائق. يمكن للمستخدمين الذين تم منحهم azure_storage_admin الدور التفاعل مع هذا الجدول عبر الوظائف. لمعرفة حسابات التخزين التي تمت إضافتها، استخدم الدالة azure_storage.account_list.
نوع
azure_storage.storage_type قيمة أحد أنواع التخزين المدعومة. القيمة المدعومة فقط هي blob.
نوع الإرجاع
jsonb
azure_storage.account_options
الدالة التي تعمل كدالة أداة مساعدة، والتي يمكن استدعاؤها كمعلمة ضمن azure_storage.account_add، وهي مفيدة لإنتاج قيمة صالحة للوسيطة account_config ، عند استخدام مفتاح وصول Azure Storage أو هوية مدارة معينة من قبل النظام للتفاعل مع حساب Azure Storage.
azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);
الأذونات
يمكن لأي مستخدم أو دور استدعاء هذه الدالة.
الوسيطات
اسم
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
auth_type
azure_storage.auth_type قيمة أحد أنواع التخزين المدعومة. القيم المدعومة فقط هي access-keyو.managed-identity
storage_type
azure_storage.storage_type قيمة أحد أنواع التخزين المدعومة. القيمة المدعومة فقط هي blob.
وثائق التفويض
text قيمة أحد مفاتيح الوصول لحساب التخزين. مفاتيح الوصول إلى تخزين Azure blob مشابهة لكلمة مرور الجذر لحساب التخزين الخاص بك. كن حذرًا دائمًا لحماية مفاتيح الوصول خاصتك. استخدم Azure Key Vault لإدارة المفاتيح وتدويرها بأمان. يتم تخزين مفتاح الحساب في جدول يمكن الوصول إليه فقط من قبل المستخدم الفائق. يمكن للمستخدمين الذين تم منحهم azure_storage_admin الدور التفاعل مع هذا الجدول عبر الوظائف. لمعرفة حسابات التخزين التي تمت إضافتها، استخدم الدالة azure_storage.account_list.
نوع الإرجاع
jsonb
azure_storage.account_remove
الدالة التي تسمح بإزالة حساب تخزين ومفتاح الوصول المرتبط به من قائمة حسابات التخزين التي يمكن للملحق azure_storage الوصول إليها.
azure_storage.account_remove(account_name_p text);
الأذونات
يجب أن يكون عضوا في azure_storage_admin.
الوسيطات
account_name_p
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
نوع الإرجاع
VOID
azure_storage.account_user_add
دالة تسمح بمنح مستخدم PostgreSQL أو دور الوصول إلى حساب تخزين من خلال الوظائف التي يوفرها azure_storage الملحق.
ملاحظة
ينجح تنفيذ هذه الدالة فقط إذا تم بالفعل إنشاء حساب التخزين، الذي يتم تمرير اسمه كوسيطة أولى، باستخدام azure_storage.account_add، وإذا كان المستخدم أو الدور، الذي تم تمرير اسمه كوسيطة ثانية، موجودا بالفعل.
azure_storage.account_add(account_name_p text, user_p regrole);
الأذونات
يجب أن يكون عضوا في azure_storage_admin.
الوسيطات
account_name_p
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
user_p
regrole اسم مستخدم PostgreSQL أو دور متوفر على الخادم.
نوع الإرجاع
VOID
azure_storage.account_user_remove
الدالة التي تسمح بإبطال مستخدم PostgreSQL أو الوصول إلى دور إلى حساب تخزين من خلال الوظائف التي يوفرها azure_storage الملحق.
ملاحظة
ينجح تنفيذ هذه الدالة فقط إذا تم بالفعل إنشاء حساب التخزين الذي تم تمرير اسمه كوسيطة أولى باستخدام azure_storage.account_add، وإذا كان المستخدم أو الدور الذي تم تمرير اسمه كوسيطة ثانية لا يزال موجودا.
عند إسقاط مستخدم أو دور من الخادم، عن طريق تنفيذ DROP USER | ROLE، يتم أيضا التخلص من الأذونات التي تم منحها على أي مرجع لحسابات Azure Storage تلقائيا.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
الأذونات
يجب أن يكون عضوا في azure_storage_admin.
الوسيطات
account_name_p
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
user_p
regrole اسم مستخدم PostgreSQL أو دور متوفر على الخادم.
نوع الإرجاع
VOID
azure_storage.account_list
الدالة التي تسرد أسماء حسابات التخزين التي تم تكوينها عبر الدالة azure_storage.account_add ، جنبا إلى جنب مع مستخدمي PostgreSQL أو الأدوار التي تم منحها أذونات للتفاعل مع حساب التخزين هذا من خلال الوظائف التي يوفرها azure_storage الملحق.
azure_storage.account_list();
الأذونات
يجب أن يكون عضوا في azure_storage_admin.
الوسيطات
لا تأخذ هذه الدالة أي وسيطات.
نوع الإرجاع
TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) جدول من أربعة أعمدة مع إضافة قائمة حسابات Azure Storage ونوع المصادقة المستخدمة للتفاعل مع كل حساب ونوع التخزين وقائمة مستخدمي PostgreSQL أو الأدوار التي يتم منحها حق الوصول إليه.
azure_storage.blob_list
الدالة التي تسرد الأسماء والخصائص الأخرى (الحجم، lastModified، eTag، contentType، contentEncoding، و contentHash) للكائنات الثنائية كبيرة الحجم المخزنة في الحاوية المحددة لحساب التخزين المشار إليه.
azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);
الأذونات
يجب إضافة المستخدم أو الدور الذي يستدعي هذه الدالة إلى القائمة المسموح بها للمحال account_name إليه، عن طريق تنفيذ azure_storage.account_user_add.
azure_storage_admin يسمح لأعضاء تلقائيا بالإشارة إلى جميع حسابات Azure Storage التي تمت إضافة مراجعها باستخدام azure_storage.account_add.
الوسيطات
account_name
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
container_name
text اسم الحاوية. تنظم الحاوية مجموعة من الكائنات الثنائية كبيرة الحجم، على غرار دليل في نظام الملفات. يمكن أن يتضمن حساب التخزين عددا غير محدود من الحاويات، ويمكن للحاوية تخزين عدد غير محدود من الكائنات الثنائية كبيرة الحجم.
يجب أن يكون اسم الحاوية اسما صالحا لنظام أسماء المجالات (DNS)، لأنه يشكل جزءا من URI الفريد المستخدم لمعالجة الحاوية أو الكائنات الثنائية كبيرة الحجم الخاصة بها.
عند تسمية حاوية، تأكد من اتباع هذه القواعد.
URI للحاوية مشابه لما يلي: https://myaccount.blob.core.windows.net/mycontainer
بادئه
text عند تحديدها، ترجع الدالة الكائنات الثنائية كبيرة الحجم التي تبدأ أسماؤها بالقيمة المتوفرة في هذه المعلمة. الإعدادات الافتراضية لسلسلة فارغة.
نوع الإرجاع
TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) تم إرجاع جدول بسجل واحد لكل كائن ثنائي كبير الحجم، بما في ذلك الاسم الكامل للكائن الثنائي كبير الحجم وبعض الخصائص الأخرى.
مسار
text الاسم الكامل للكائن الثنائي كبير الحجم.
بايت
bigint حجم الكائن الثنائي كبير الحجم بالبايت.
last_modified
timestamp with time zoneتاريخ ووقت آخر تعديل للكائن الثنائي كبير الحجم. أي عملية تقوم بتعديل الكائن الثنائي كبير الحجم، بما في ذلك تحديث بيانات تعريف الكائن الثنائي كبير الحجم أو خصائصه، تغير وقت آخر تعديل للكائن الثنائي كبير الحجم.
إيتاغ
text يتم استخدام الخاصية ETag للتزامن المتفائل أثناء التحديثات. إنه ليس طابعا زمنيا حيث توجد خاصية أخرى تسمى الطابع الزمني تخزن آخر مرة تم فيها تحديث سجل. على سبيل المثال، إذا قمت بتحميل كيان وتريد تحديثه، يجب أن يتطابق ETag مع ما يتم تخزينه حاليا. يعد تعيين ETag المناسب مهما لأنه إذا كان لديك عدة مستخدمين يقومون بتحرير العنصر نفسه، فأنت لا تريد منهم الكتابة فوق تغييرات بعضهم البعض.
content_type
text نوع المحتوى المحدد للكائن الثنائي كبير الحجم. نوع المحتوى الافتراضي هو application/octet-stream.
content_encoding
text خاصية ترميز المحتوى للكائن الثنائي كبير الحجم الذي يسمح لك Azure Storage بتعريفه. بالنسبة للمحتوى المضغوط، يمكنك تعيين الخاصية لتكون Gzip. عندما يصل المستعرض إلى المحتوى، فإنه يقوم تلقائيا بإلغاء ضغط المحتوى.
content_hash
text التجزئة المستخدمة للتحقق من سلامة الكائن الثنائي كبير الحجم أثناء النقل. عند تحديد هذا العنوان، تتحقق خدمة التخزين من التجزئة المتوفرة مع تجزئة حوسبة من المحتوى. إذا لم تتطابق التجزئتان، تفشل العملية مع رمز الخطأ 400 (طلب غير صحيح).
azure_storage.blob_get
الدالة التي تسمح باستيراد البيانات. يقوم بتنزيل ملف من حاوية كائن ثنائي كبير الحجم في حساب Azure Storage. ثم يترجم المحتويات إلى صفوف، والتي يمكن استهلاكها ومعالجتها باستخدام بنيات لغة SQL. تضيف هذه الدالة دعما لتصفية البيانات التي تم جلبها من حاوية الكائن الثنائي كبير الحجم ومعالجتها قبل استيرادها.
ملاحظة
قبل محاولة الوصول إلى الحاوية لحساب التخزين المشار إليه، تتحقق هذه الدالة مما إذا كانت أسماء حساب التخزين والحاوية التي تم تمريرها كوسيطات صالحة وفقا لقواعد التحقق من صحة التسمية المفروضة على حسابات تخزين Azure. إذا كان أي منهما غير صالح، يتم رفع خطأ.
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);
هناك إصدار محمل تحميلا زائدا من هذه الدالة، والذي يقبل معلمة rec تسمح لك بتعريف سجل تنسيق الإخراج بشكل ملائم.
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);
الأذونات
يجب إضافة المستخدم أو الدور الذي يستدعي هذه الدالة إلى القائمة المسموح بها للمحال account_name إليه، عن طريق تنفيذ azure_storage.account_user_add.
azure_storage_admin يسمح لأعضاء تلقائيا بالإشارة إلى جميع حسابات Azure Storage التي تمت إضافة مراجعها باستخدام azure_storage.account_add.
الوسيطات
account_name
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
container_name
text اسم الحاوية. تنظم الحاوية مجموعة من الكائنات الثنائية كبيرة الحجم، على غرار دليل في نظام الملفات. يمكن أن يتضمن حساب التخزين عددا غير محدود من الحاويات، ويمكن للحاوية تخزين عدد غير محدود من الكائنات الثنائية كبيرة الحجم.
يجب أن يكون اسم الحاوية اسما صالحا لنظام أسماء المجالات (DNS)، لأنه يشكل جزءا من URI الفريد المستخدم لمعالجة الحاوية أو الكائنات الثنائية كبيرة الحجم الخاصة بها.
عند تسمية حاوية، تأكد من اتباع هذه القواعد.
URI للحاوية مشابه لما يلي: https://myaccount.blob.core.windows.net/mycontainer
مسار
text الاسم الكامل للكائن الثنائي كبير الحجم.
تفصيل
anyelement تعريف بنية إخراج السجل.
فك
text مواصفات تنسيق الكائن الثنائي كبير الحجم. يمكن تعيين إلى أي من القيم التالية:
| التنسيق | الإعداد الافتراضي | الوصف |
|---|---|---|
auto |
true |
يستنتج القيمة استنادا إلى السلسلة الأخيرة من الأحرف المعينة لاسم الكائن الثنائي كبير الحجم. إذا كان اسم الكائن الثنائي كبير الحجم ينتهي ب .parquet، فإنه يفترض parquet. إذا كان ينتهي ب .csv أو .csv.gz، فإنه يفترض csv. إذا كان ينتهي ب .tsv أو .tsv.gz، فإنه يفترض tsv. إذا كان ينتهي ب .jsonأو .json.gz.xmlأو .xml.gz.txt.txt.gz، فإنه يفترض .text |
binary |
تنسيق Copy ثنائي PostgreSQL. | |
csv |
تنسيق القيم المفصولة بفواصل المستخدم بواسطة PostgreSQL COPY. | |
parquet |
تنسيق باركيه. | |
text | xml | json |
ملف يحتوي على قيمة نصية واحدة. | |
tsv |
قيم مفصولة بعلامات جدولة، تنسيق PostgreSQL COPY الافتراضي. |
ضغط
text مواصفات نوع الضغط. يمكن تعيين إلى أي من القيم التالية:
| التنسيق | الإعداد الافتراضي | الوصف |
|---|---|---|
auto |
true |
يستنتج القيمة استنادا إلى السلسلة الأخيرة من الأحرف المعينة لاسم الكائن الثنائي كبير الحجم. إذا كان اسم الكائن الثنائي كبير الحجم ينتهي ب .gz، فإنه يفترض gzip. وإلا، فإنه يفترض none. |
brotli |
استخدام خوارزمية ضغط brotli لضغط الكائن الثنائي كبير الحجم. مدعوم فقط من قبل parquet أداة الترميز. |
|
gzip |
استخدام خوارزمية ضغط gzip لضغط الكائن الثنائي كبير الحجم. | |
lz4 |
استخدام خوارزمية ضغط lz4 لضغط الكائن الثنائي كبير الحجم. مدعوم فقط من قبل parquet أداة الترميز. |
|
none |
يفرض عدم ضغط الكائن الثنائي كبير الحجم. | |
snappy |
القوى التي تستخدم خوارزمية ضغط مصغرة لضغط الكائن الثنائي كبير الحجم. مدعوم فقط من قبل parquet أداة الترميز. |
|
zstd |
استخدام خوارزمية ضغط zstd لضغط الكائن الثنائي كبير الحجم. مدعوم فقط من قبل parquet أداة الترميز. |
لا يدعم الملحق أي أنواع ضغط أخرى.
خيارات
jsonb الإعدادات التي تحدد معالجة الرؤوس المخصصة والفواصل المخصصة وأحرف الإلغاء وما إلى ذلك. options يؤثر على سلوك هذه الدالة بطريقة مشابهة لكيفية تأثير الخيارات التي يمكنك تمريرها إلى COPY الأمر في PostgreSQL على سلوكها.
نوع الإرجاع
SETOF record
SETOF anyelement
azure_storage.blob_put
الدالة التي تسمح بتصدير البيانات، عن طريق تحميل الملفات إلى حاوية كائن ثنائي كبير الحجم في حساب Azure Storage. يتم إنتاج محتوى الملفات من صفوف في PostgreSQL.
ملاحظة
قبل محاولة الوصول إلى الحاوية لحساب التخزين المشار إليه، تتحقق هذه الدالة مما إذا كانت أسماء حساب التخزين والحاوية التي تم تمريرها كوسيطات صالحة وفقا لقواعد التحقق من صحة التسمية المفروضة على حسابات تخزين Azure. إذا كان أي منهما غير صالح، يتم رفع خطأ.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
هناك إصدار محمل بشكل زائد من الدالة، يحتوي على encoder معلمة تسمح لك بتحديد أداة الترميز لاستخدامها عندما لا يمكن استنتاجها من ملحق المعلمة path ، أو عندما تريد تجاوز المستنتج.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
هناك إصدار محمل تحميلا زائدا من الدالة يحتوي أيضا على معلمة compression تسمح لك بتحديد الضغط لاستخدامه عندما لا يمكن استنتاجه من ملحق المعلمة path ، أو عندما تريد تجاوز الضغط المستنتج.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
هناك إصدار محمل بشكل زائد من الدالة يحتوي أيضا على معلمة options للتعامل مع الرؤوس المخصصة والفواصل المخصصة وأحرف الإلغاء وما إلى ذلك options تعمل بطريقة مماثلة للخيارات التي يمكن تمريرها إلى COPY الأمر في PostgreSQL.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;
الأذونات
يجب إضافة المستخدم أو الدور الذي يستدعي هذه الدالة إلى القائمة المسموح بها للمحال account_name إليه، عن طريق تنفيذ azure_storage.account_user_add.
azure_storage_admin يسمح لأعضاء تلقائيا بالإشارة إلى جميع حسابات Azure Storage التي تمت إضافة مراجعها باستخدام azure_storage.account_add.
الوسيطات
account_name
text اسم حساب تخزين Azure blob الذي يحتوي على جميع العناصر الخاصة بك: الكائنات الثنائية كبيرة الحجم والملفات وقوائم الانتظار والجداول. يوفر حساب التخزين مساحة اسم فريدة يمكن الوصول إليها من أي مكان في العالم عبر HTTPS.
container_name
text اسم الحاوية. تنظم الحاوية مجموعة من الكائنات الثنائية كبيرة الحجم، على غرار دليل في نظام الملفات. يمكن أن يتضمن حساب التخزين عددا غير محدود من الحاويات، ويمكن للحاوية تخزين عدد غير محدود من الكائنات الثنائية كبيرة الحجم.
يجب أن يكون اسم الحاوية اسما صالحا لنظام أسماء المجالات (DNS)، لأنه يشكل جزءا من URI الفريد المستخدم لمعالجة الحاوية أو الكائنات الثنائية كبيرة الحجم الخاصة بها.
عند تسمية حاوية، تأكد من اتباع هذه القواعد.
URI للحاوية مشابه لما يلي: https://myaccount.blob.core.windows.net/mycontainer
مسار
text الاسم الكامل للكائن الثنائي كبير الحجم.
المجموعه
record تعريف بنية إخراج السجل.
التشفير
text مواصفات تنسيق الكائن الثنائي كبير الحجم. يمكن تعيين إلى أي من القيم التالية:
| التنسيق | الإعداد الافتراضي | الوصف |
|---|---|---|
auto |
true |
يستنتج القيمة استنادا إلى السلسلة الأخيرة من الأحرف المعينة لاسم الكائن الثنائي كبير الحجم. إذا كان اسم الكائن الثنائي كبير الحجم ينتهي ب .csv أو .csv.gz، فإنه يفترض csv. إذا كان ينتهي ب .tsv أو .tsv.gz، فإنه يفترض tsv. إذا كان ينتهي ب .jsonأو .json.gz.xmlأو .xml.gz.txt.txt.gz، فإنه يفترض .text |
binary |
تنسيق Copy ثنائي PostgreSQL. | |
csv |
تنسيق القيم المفصولة بفواصل المستخدم بواسطة PostgreSQL COPY. | |
parquet |
تنسيق باركيه. | |
text | xml | json |
ملف يحتوي على قيمة نصية واحدة. | |
tsv |
قيم مفصولة بعلامات جدولة، تنسيق PostgreSQL COPY الافتراضي. |
ضغط
text مواصفات نوع الضغط. يمكن تعيين إلى أي من القيم التالية:
| التنسيق | الإعداد الافتراضي | الوصف |
|---|---|---|
auto |
true |
يستنتج القيمة استنادا إلى السلسلة الأخيرة من الأحرف المعينة لاسم الكائن الثنائي كبير الحجم. إذا كان اسم الكائن الثنائي كبير الحجم ينتهي ب .gz، فإنه يفترض gzip. وإلا، فإنه يفترض none. |
brotli |
استخدام خوارزمية ضغط brotli لضغط الكائن الثنائي كبير الحجم. مدعوم فقط من قبل parquet أداة الترميز. |
|
gzip |
استخدام خوارزمية ضغط gzip لضغط الكائن الثنائي كبير الحجم. | |
lz4 |
استخدام خوارزمية ضغط lz4 لضغط الكائن الثنائي كبير الحجم. مدعوم فقط من قبل parquet أداة الترميز. |
|
none |
يفرض عدم ضغط الكائن الثنائي كبير الحجم. | |
snappy |
القوى التي تستخدم خوارزمية ضغط مصغرة لضغط الكائن الثنائي كبير الحجم. مدعوم فقط من قبل parquet أداة الترميز. |
|
zstd |
استخدام خوارزمية ضغط zstd لضغط الكائن الثنائي كبير الحجم. مدعوم فقط من قبل parquet أداة الترميز. |
لا يدعم الملحق أي أنواع ضغط أخرى.
خيارات
jsonb الإعدادات التي تحدد معالجة الرؤوس المخصصة والفواصل المخصصة وأحرف الإلغاء وما إلى ذلك. options يؤثر على سلوك هذه الدالة بطريقة مشابهة لكيفية تأثير الخيارات التي يمكنك تمريرها إلى COPY الأمر في PostgreSQL على سلوكها.
نوع الإرجاع
VOID
azure_storage.options_copy
الدالة التي تعمل كدالة أداة مساعدة، والتي يمكن استدعاؤها كمعلمة داخل blob_get. تعمل كدالة مساعدة options_parquetoptions_csv_getoptions_tsvoptions_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);
الأذونات
يمكن لأي مستخدم أو دور استدعاء هذه الدالة.
الوسيطات
المحدِّد
text الحرف الذي يفصل الأعمدة داخل كل صف (سطر) من الملف. يجب أن يكون حرف واحد 1 بايت. على الرغم من أن هذه الدالة تدعم المحددات لأي عدد من الأحرف، إذا حاولت استخدام أكثر من حرف واحد من 1 بايت، فإن PostgreSQL يبلغ عن COPY delimiter must be a single one-byte character خطأ.
null_string
text السلسلة التي تمثل قيمة خالية. الإعداد الافتراضي هو \N (شرطة مائلة عكسية-N) بتنسيق نصي، وسلسلة فارغة غير موقوفة بتنسيق CSV. قد تفضل سلسلة فارغة حتى في تنسيق النص للحالات التي لا تريد تمييز القيم الخالية من السلاسل الفارغة.
راس
boolean علامة تشير إلى ما إذا كان الملف يحتوي على سطر رأس مع أسماء كل عمود في الملف. في الإخراج، يحتوي السطر الأولي على أسماء الأعمدة من الجدول.
عرض الأسعار
text حرف الاقتباس الذي سيتم استخدامه عند اقتباس قيمة بيانات. الإعداد الافتراضي هو عرض أسعار مزدوج. يجب أن يكون حرف واحد 1 بايت. على الرغم من أن هذه الدالة تدعم المحددات لأي عدد من الأحرف، إذا حاولت استخدام أكثر من حرف واحد من 1 بايت، فإن PostgreSQL يبلغ عن COPY quote must be a single one-byte character خطأ.
فرار
text الحرف الذي يجب أن يظهر قبل حرف بيانات يطابق قيمة QUOTE. الإعداد الافتراضي هو نفس قيمة QUOTE (بحيث يتم مضاعفة حرف الاقتباس إذا ظهر في البيانات). يجب أن يكون حرف واحد 1 بايت. على الرغم من أن هذه الدالة تدعم المحددات لأي عدد من الأحرف، إذا حاولت استخدام أكثر من حرف واحد من 1 بايت، فإن PostgreSQL يبلغ عن COPY escape must be a single one-byte character خطأ.
force_quote
text[] يفرض استخدام الاقتباس لكافة القيم غير الفارغة في كل عمود محدد. لا يتم اقتباس إخراج NULL أبدا. إذا تم تحديد *، يتم اقتباس القيم غير الفارغة في كافة الأعمدة.
force_not_null
text[] لا تتطابق مع قيم الأعمدة المحددة مقابل السلسلة الخالية. في الحالة الافتراضية حيث تكون السلسلة الخالية فارغة، فهذا يعني أن القيم الفارغة تتم قراءتها كسلاسل ذات طول صفري بدلا من القيم الخالية، حتى عندما لا يتم اقتباسها.
force_null
text[] مطابقة قيم الأعمدة المحددة مقابل السلسلة الفارغة، حتى إذا تم اقتباسها، وإذا تم العثور على تطابق، فقم بتعيين القيمة إلى NULL. في الحالة الافتراضية حيث تكون السلسلة الفارغة فارغة، فإنها تحول سلسلة فارغة مقتبسة إلى NULL.
content_encoding
text اسم الترميز الذي يتم ترميز الملف به. إذا تم حذف الخيار، يتم استخدام ترميز العميل الحالي.
نوع الإرجاع
jsonb
azure_storage.options_parquet
الدالة التي تعمل كدالة أداة مساعدة، والتي يمكن استدعاؤها كمعلمة داخل blob_get، وهي مفيدة لفك ترميز محتوى ملف parquet.
azure_storage.options_parquet();
الأذونات
يمكن لأي مستخدم أو دور استدعاء هذه الدالة.
الوسيطات
نوع الإرجاع
jsonb
azure_storage.options_csv_get
الدالة التي تعمل كدالة أداة مساعدة، والتي يمكن استدعاؤها كمعلمة داخل blob_get، وهي مفيدة لفك ترميز محتوى ملف csv.
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);
الأذونات
يمكن لأي مستخدم أو دور استدعاء هذه الدالة.
الوسيطات
المحدِّد
text الحرف الذي يفصل الأعمدة داخل كل صف (سطر) من الملف. يجب أن يكون حرف واحد 1 بايت. على الرغم من أن هذه الدالة تدعم المحددات لأي عدد من الأحرف، إذا حاولت استخدام أكثر من حرف واحد من 1 بايت، فإن PostgreSQL يبلغ عن COPY delimiter must be a single one-byte character خطأ.
null_string
text السلسلة التي تمثل قيمة خالية. الإعداد الافتراضي هو \N (شرطة مائلة عكسية-N) بتنسيق نصي، وسلسلة فارغة غير موقوفة بتنسيق CSV. قد تفضل سلسلة فارغة حتى في تنسيق النص للحالات التي لا تريد تمييز القيم الخالية من السلاسل الفارغة.
راس
boolean علامة تشير إلى ما إذا كان الملف يحتوي على سطر رأس مع أسماء كل عمود في الملف. في الإخراج، يحتوي السطر الأولي على أسماء الأعمدة من الجدول.
عرض الأسعار
text حرف الاقتباس الذي سيتم استخدامه عند اقتباس قيمة بيانات. الإعداد الافتراضي هو عرض أسعار مزدوج. يجب أن يكون حرف واحد 1 بايت. على الرغم من أن هذه الدالة تدعم المحددات لأي عدد من الأحرف، إذا حاولت استخدام أكثر من حرف واحد من 1 بايت، فإن PostgreSQL يبلغ عن COPY quote must be a single one-byte character خطأ.
فرار
text الحرف الذي يجب أن يظهر قبل حرف بيانات يطابق قيمة QUOTE. الإعداد الافتراضي هو نفس قيمة QUOTE (بحيث يتم مضاعفة حرف الاقتباس إذا ظهر في البيانات). يجب أن يكون حرف واحد 1 بايت. على الرغم من أن هذه الدالة تدعم المحددات لأي عدد من الأحرف، إذا حاولت استخدام أكثر من حرف واحد من 1 بايت، فإن PostgreSQL يبلغ عن COPY escape must be a single one-byte character خطأ.
force_not_null
text[] لا تتطابق مع قيم الأعمدة المحددة مقابل السلسلة الخالية. في الحالة الافتراضية حيث تكون السلسلة الخالية فارغة، فهذا يعني أن القيم الفارغة تتم قراءتها كسلاسل ذات طول صفري بدلا من القيم الخالية، حتى عندما لا يتم اقتباسها.
force_null
text[] مطابقة قيم الأعمدة المحددة مقابل السلسلة الفارغة، حتى إذا تم اقتباسها، وإذا تم العثور على تطابق، فقم بتعيين القيمة إلى NULL. في الحالة الافتراضية حيث تكون السلسلة الفارغة فارغة، فإنها تحول سلسلة فارغة مقتبسة إلى NULL.
content_encoding
text اسم الترميز الذي يتم ترميز الملف به. إذا تم حذف الخيار، يتم استخدام ترميز العميل الحالي.
نوع الإرجاع
jsonb
azure_storage.options_tsv
الدالة التي تعمل كدالة أداة مساعدة، والتي يمكن استدعاؤها كمعلمة داخل blob_get، وهي مفيدة لفك ترميز محتوى ملف tsv.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
الأذونات
يمكن لأي مستخدم أو دور استدعاء هذه الدالة.
الوسيطات
المحدِّد
text الحرف الذي يفصل الأعمدة داخل كل صف (سطر) من الملف. يجب أن يكون حرف واحد 1 بايت. على الرغم من أن هذه الدالة تدعم المحددات لأي عدد من الأحرف، إذا حاولت استخدام أكثر من حرف واحد من 1 بايت، فإن PostgreSQL يبلغ عن COPY delimiter must be a single one-byte character خطأ.
null_string
text السلسلة التي تمثل قيمة خالية. الإعداد الافتراضي هو \N (شرطة مائلة عكسية-N) بتنسيق نصي، وسلسلة فارغة غير موقوفة بتنسيق CSV. قد تفضل سلسلة فارغة حتى في تنسيق النص للحالات التي لا تريد تمييز القيم الخالية من السلاسل الفارغة.
content_encoding
text اسم الترميز الذي يتم ترميز الملف به. إذا تم حذف الخيار، يتم استخدام ترميز العميل الحالي.
نوع الإرجاع
jsonb
azure_storage.options_binary
الدالة التي تعمل كدالة أداة مساعدة، والتي يمكن استدعاؤها كمعلمة داخل blob_get، وهي مفيدة لفك ترميز محتوى ملف ثنائي.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
الأذونات
يمكن لأي مستخدم أو دور استدعاء هذه الدالة.
الوسيطات
content_encoding
text اسم الترميز الذي يتم ترميز الملف به. إذا تم حذف الخيار، يتم استخدام ترميز العميل الحالي.
نوع الإرجاع
jsonb