إنشاء وحدة تخزين

ينطبق على:وضع علامة Databricks SQL وضع علامة Databricks Runtime 13.3 LTS وما فوق وضع علامة كتالوج Unity فقط

إنشاء وحدة تخزين بالاسم المحدد. إذا كانت وحدة تخزين بنفس الاسم موجودة بالفعل في SCHEMA_NOT_FOUND المخطط يتم رفعها.

راجع وحدات التخزين للحصول على تفاصيل حول استخدام وحدات التخزين.

بناء الجملة

CREATE [ EXTERNAL ] VOLUME [ IF NOT EXISTS ] volume_name
    [ LOCATION location_path ]
    [ COMMENT comment ]

المعلمات

  • الخارجيه

    إنشاء وحدة تخزين خارجية. إذا EXTERNAL لم يتم تحديد العبارة تنشئ وحدة تخزين مدارة.

  • إذا لم يكن موجودا

    إنشاء وحدة تخزين بالاسم المحدد إذا لم تكن موجودة. إذا كانت وحدة تخزين بنفس الاسم موجودة بالفعل، فلن يحدث أي شيء.

  • volume_name

    اسم وحدة التخزين التي سيتم إنشاؤها. يمكن إنشاء وحدات التخزين فقط في مخططات كتالوج Unity.

  • موقع location_path

    location_pathهو حرفي STRING يحدد مسار نظام الملفات الذي يتم فيه إنشاء وحدة التخزين الخارجية المحددة. إذا لم يكن المسار المحدد موجودا في نظام الملفات الأساسي، ينشئ دليلا بالمسار. يجب ألا يتداخل المسار المختار مع موقع أي وحدات تخزين أو جداول أخرى.

  • لا تنطبق هذه العبارة على وحدات التخزين المدارة.

  • التعليق

    وصف حرفي اختياري STRING للحجم.

الأمثلة


-- Create an external volume on the specified location with comment
> CREATE EXTERNAL VOLUME my_catalog.my_schema.my_external_volume
    LOCATION 's3://my-bucket/my-location/my-path'
    COMMENT 'This is my example external volume on S3'
  OK

-- Query the data from the file in the created volume
> SELECT *
    FROM csv.`/Volumes/my_catalog/my_schema/my_external_volume/foo.csv`

-- Create a managed volume with full schema name
> CREATE VOLUME my_catalog.my_schema.my_volume
  OK

-- Create a managed volume in default catalog and schema
> CREATE VOLUME my_another_volume
  OK