الصياغة
- سلسلة اتصال
- عنوان URL لحساب التخزين
- مجموعة مسماة
تكون بيانات الاعتماد مضمنة في سلسلة اتصال، لذلك لا حاجة إلى
account_name/account_key بشكل منفصل:وسيطات الدالة
المجموعات المسماة
تختلف أسماء مفاتيح المجموعات المسماة عن أسماء الوسائط الموضعية للدالة:
container (وليس container_name) وblob_path (وليس blobpath).القيمة المعادة
أمثلة
القراءة بصيغة storage_account_url
القراءة باستخدام صيغة connection_string
الكتابة باستخدام التقسيمات
{_partition_id} إلى استراتيجية التقسيم WILDCARD. بالنسبة إلى المسارات التي لا تحتوي على العنصر النائب، تكون HIVE هي استراتيجية التقسيم الافتراضية عندما يكون compatibility بالإصدار 26.6 أو أحدث (بما في ذلك القيم الافتراضية الحالية)؛ راجع الإعداد file_like_engine_default_partition_strategy.
الأعمدة الافتراضية
_path— مسار الملف. النوع:LowCardinality(String)._file— اسم الملف. النوع:LowCardinality(String)._size— حجم الملف بالبايت. النوع:Nullable(UInt64). إذا كان حجم الملف غير معروف، تكون القيمةNULL._time— وقت آخر تعديل للملف. النوع:Nullable(DateTime). إذا كان الوقت غير معروف، تكون القيمةNULL.
الكتابة مع التقسيم
استراتيجية التقسيم
INSERT.
WILDCARD: يستبدل الرمز البديل {_partition_id} في مسار الملف بمفتاح التقسيم الفعلي. ويُختار افتراضيًا عندما يحتوي المسار على عنصر نائب {_partition_id} (إذ إنها الاستراتيجية الوحيدة المتوافقة مع مثل هذا المسار)، أو عند استخدام إعدادات compatibility الأقدم من 26.6؛ أما في الحالات المتبقية، تكون القيمة الافتراضية هي HIVE (راجع الإعداد file_like_engine_default_partition_strategy).
يعتمد HIVE التقسيم بأسلوب Hive لعمليات القراءة & الكتابة. ويُنشئ الملفات بالتنسيق التالي: <prefix>/<key1=val1/key2=val2...>/<snowflakeid>.<toLower(file_format)>.
مثال على استراتيجية التقسيم HIVE
إعداد use_hive_partitioning
partition_strategy.
عند تعيين use_hive_partitioning إلى القيمة 1، سيكتشف ClickHouse التقسيم بأسلوب Hive في المسار (/name=value/) وسيتيح استخدام أعمدة التقسيم كأعمدة افتراضية في الاستعلام. وستحمل هذه الأعمدة الافتراضية الأسماء نفسها الموجودة في المسار المُقسَّم.
مثال
استخدم عمودًا افتراضيًا أُنشئ باستخدام التقسيم بأسلوب Hive
azureBlobStorage Shared Access Signatures (SAS).
يحتوي Blob SAS token على جميع المعلومات اللازمة لمصادقة الطلب، بما في ذلك الـ blob المستهدف، والأذونات، وفترة الصلاحية. ولإنشاء URL للـ blob، ألحِق SAS token بنقطة نهاية خدمة الـ blob. على سبيل المثال، إذا كانت نقطة النهاية هي https://clickhousedocstest.blob.core.windows.net/، يصبح الطلب كما يلي: