مرجع أوامر Milvus_CLI

واجهة سطر الأوامر Milvus (CLI) هي أداة سطر أوامر تدعم الاتصال بقاعدة البيانات وعمليات البيانات واستيراد البيانات وتصديرها.

يقدم هذا الموضوع جميع الأوامر المدعومة والخيارات المقابلة لها. كما يتم تضمين بعض الأمثلة للرجوع إليها.

مجموعات الأوامر

يتم تنظيم أوامر Milvus CLI في المجموعات التالية:

  • create: إنشاء مجموعة أو قاعدة بيانات أو قسم أو مستخدم أو دور أو فهرس
  • delete: حذف المجموعة أو قاعدة البيانات أو القسم أو الاسم المستعار أو المستخدم أو الدور أو الفهرس
  • list: قائمة بالمجموعات أو قواعد البيانات أو الأقسام أو المستخدمين أو الأدوار أو المنح أو الفهارس
  • show: إظهار الاتصال أو قاعدة البيانات أو المجموعة أو التحميل_التقدم أو تقدم الفهرس
  • grant: منح دور أو امتياز
  • revoke: إبطال الدور أو الامتياز
  • load: تحميل مجموعة أو قسم
  • release: تحرير المجموعة أو القسم
  • use: استخدام قاعدة البيانات
  • rename: إعادة تسمية المجموعة
  • insert: إدراج كيانات (ملف أو صف)

مسح

مسح الشاشة.

بناء الجملة

clear

خيارات

الخيارالاسم الكاملالوصف
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

الاتصال

يتصل بميلفوس.

بناء الجملة

connect [-uri (text)] [-t (text)]
connect [-uri (text)] [-t (text)] [-tls (0|1)] [-cert (text)]

خيارات

الخيارالاسم الكاملالوصف
-uri-uri(اختياري) اسم uri. الافتراضي هو "http://127.0.0.1:19530".
-t-الرمز المميز(اختياري) الرمز المميز ل zilliz cloud apikey أو username:password. الافتراضي هو لا شيء.
-tls-tlsmode(اختياري) تعيين وضع TLS: 0 (لا يوجد تشفير)، 1 (تشفير أحادي الاتجاه)، 2 (التشفير ثنائي الاتجاه غير مدعوم بعد). الافتراضي هو 0
-شهادة-Cert(اختياري) المسار إلى ملف شهادة العميل. العمل مع التشفير أحادي الاتجاه
-مساعدةغير متوفرعرض التعليمات الخاصة باستخدام الأمر.

مثال

milvus_cli > connect -uri http://127.0.0.1:19530

إنشاء قاعدة بيانات

إنشاء قاعدة بيانات في ميلفوس

بناء الجملة

create database -db (text)

الخيارات

الخيارالاسم الكاملالوصف
-db-db_name[مطلوب] اسم قاعدة البيانات في ميلفوس.
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

أمثلة

مثال 1

يقوم المثال التالي بإنشاء قاعدة البيانات testdb في ميلفوس.

milvus_cli > create database -db testdb

استخدام قاعدة البيانات

استخدام قاعدة البيانات في ملفوس

بناء الجملة

use database -db (text)

الخيارات

الخيارالاسم الكاملالوصف
-db-db_name[مطلوب] اسم قاعدة البيانات في ميلفوس.
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

أمثلة

مثال 1

يستخدم المثال التالي قاعدة البيانات testdb في ميلفوس.

milvus_cli > use database -db testdb

قائمة قواعد البيانات

سرد قواعد البيانات في ملفوس

بناء الجملة

list databases

أمثلة

المثال 1

يسرد المثال التالي قائمة قواعد البيانات في ملفوس.

milvus_cli > list databases

حذف قاعدة البيانات

حذف قاعدة بيانات في ملفوس

بناء الجملة

delete database -db (text)

الخيارات

الخيارالاسم الكاملالوصف
-db-db_name[مطلوب] اسم قاعدة البيانات في ميلفوس.
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

أمثلة

مثال 1

يقوم المثال التالي بحذف قاعدة البيانات testdb في ميلفوس.

milvus_cli > delete database -db testdb

Warning! You are trying to delete the database. This action cannot be undone!
Do you want to continue? [y/N]: y

إنشاء مستخدم

إنشاء مستخدم في ملفوس

بناء الجملة

create user -u (text) -p (text)

الخيارات

الخيارالاسم الكاملالوصف
-p-كلمة المروركلمة مرور المستخدم في ميلفوس. الافتراضي هو "لا شيء".
-u-اسم المستخدماسم المستخدم في ميلفوس. الافتراضي هو "بلا".
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

أمثلة

مثال 1

ينشئ المثال التالي المستخدم zilliz وكلمة المرور zilliz في ميلفوس.

milvus_cli > create user -u zilliz -p zilliz

إنشاء دور

إنشاء دور في ميلفوس

بناء الجملة

create role -r (text)

الخيارات

الخيارالاسم الكاملالوصف
-r-roleNameاسم دور دور ميلفوس.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

أمثلة

مثال 1

المثال التالي إنشاء الدور role1 في ميلفوس.

milvus_cli > create role -r role1

إنشاء اسم مستعار

تحديد أسماء مستعارة فريدة لمجموعة ما.

يمكن أن تحتوي المجموعة على عدة أسماء مستعارة. ومع ذلك، يتوافق الاسم المستعار مع مجموعة واحدة كحد أقصى.

بناء الجملة

create alias -c (text) -a (text) [-A]

خيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة.
-a-الاسم المستعارالاسم المستعار.
-A-تغيير(اختياري) علامة لنقل الاسم المستعار إلى مجموعة محددة.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

أمثلة

مثال 1

ينشئ المثال التالي carAlias1 و carAlias2 الأسماء المستعارة للمجموعة car.

milvus_cli > create alias -c car -a carAlias1

مثال 2

يعتمد المثال 2 على المثال 1.

ينقل المثال التالي الاسم المستعار carAlias1 من المجموعة car إلى المجموعة car2.

milvus_cli > create alias -c car2 -A -a carAlias1

إنشاء مجموعة

إنشاء مجموعة.

بناء الجملة

create collection

مثال تفاعلي

milvus_cli > create collection

Please input collection name: car
Please input auto id [False]: False
Please input description []: car collection
Is support dynamic field [False]: False
Please input consistency level(Strong(0),Bounded(1), Session(2), and Eventually(3)) [1]: 1
Please input shards number [1]: 1

Field name: id
Field type (INT64, VARCHAR, FLOAT_VECTOR, etc.): INT64
Field description []: primary key
Is id the primary key? [y/N]: y

Field name: vector
Field type (INT64, VARCHAR, FLOAT_VECTOR, etc.): FLOAT_VECTOR
Field description []: vector field
Dimension: 128

Field name: color
Field type (INT64, VARCHAR, FLOAT_VECTOR, etc.): INT64
Field description []: color field
Nullable [False]: False
Default value (type: INT64) [Not set]: 0

Do you want to add embedding function? [y/N]: n

إنشاء قسم

إنشاء قسم.

بناء الجملة

create partition -c (text) -p (text) [-d (text)]

خيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة.
-p-التقسيماسم القسم.
-d-الوصف(اختياري) وصف القسم.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > create partition -c car -p new_partition -d test_add_partition

إنشاء فهرس

إنشاء فهرس لحقل ما.

تدعم المجموعة حاليًا فهرسًا واحدًا كحد أقصى.

بناء الجملة

create index

مثال تفاعلي

milvus_cli > create index

Collection name (car, car2): car2
The name of the field to create an index for (vector): vector
Index name: vectorIndex
Index type (FLAT, IVF_FLAT, IVF_SQ8, IVF_PQ, RNSG, HNSW, ANNOY, AUTOINDEX, DISKANN, GPU_IVF_FLAT, GPU_IVF_PQ, SPARSE_INVERTED_INDEX, SCANN, STL_SORT, Trie, INVERTED): IVF_FLAT
Vector Index metric type (L2, IP, HAMMING, TANIMOTO, COSINE): L2
Index params nlist: 2
Timeout []:

حذف مستخدم

حذف مستخدم

بناء الجملة

delete user -u (text)

الخيارات

الخيارالاسم الكاملالوصف
-u-اسم المستخدماسم المستخدم.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > delete user -u zilliz

Warning! You are trying to delete the user in milvus. This action cannot be undone!
Do you want to continue? [y/N]: y

حذف الدور

حذف الدور في ميلفوس

بناء الجملة

delete role -r (text)

الخيارات

الخيارالاسم الكاملالوصف
-r-roleNameاسم دور دور ميلفوس.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

أمثلة

يقوم المثال التالي بحذف الدور role1 في ميلفوس.

milvus_cli > delete role -r role1

حذف الاسم المستعار

حذف اسم مستعار.

بناء الجملة

delete alias -a (text)

الخيارات

الخيارالاسم المستعارالوصف
-a-الاسم المستعار-الاسم المستعارالاسم المستعار.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

حذف مجموعة

حذف مجموعة.

بناء الجملة

delete collection -c (text)

خيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة المراد حذفها.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > delete collection -c car

Warning! You are trying to delete the collection. This action cannot be undone!
Do you want to continue? [y/N]: y

حذف الكيانات

حذف الكيانات.

بناء الجملة

delete entities -c (text) -p (text)

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة التي تنتمي إليها الكيانات المراد حذفها.
-p-قسم(اختياري) اسم القسم المراد حذفه.
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

مثال

milvus_cli > delete entities -c car

The expression to specify entities to be deleted, such as "film_id in [ 0, 1 ]": film_id in [ 0, 1 ]

Warning! You are trying to delete the entities of collection. This action cannot be undone!
Do you want to continue? [y/N]: y

حذف قسم

حذف قسم.

بناء الجملة

delete partition -c (text) -p (text)

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة التي ينتمي إليها القسم المراد حذفه.
-p-قسماسم القسم المراد حذفه.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > delete partition -c car -p new_partition

حذف الفهرس

يقوم بحذف فهرس وملفات الفهرس المقابلة.

تدعم المجموعة حالياً فهرساً واحداً كحد أقصى.

بناء الجملة

delete index -c (text) -in (text)

خيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة.
-في-اسم الفهرساسم اسم الفهرس.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > delete index -c car -in indexName

Warning! You are trying to delete the index of collection. This action cannot be undone!
Do you want to continue? [y/N]: y

منح دور

منح دور للمستخدم

بناء الجملة

grant role -r (text) -u (text)

خيارات

الخيارالاسم الكاملالوصف
-r-roleNameاسم دور دور ميلفوس.
-u-اسم المستخدماسم المستخدم لمستخدم ميلفوس.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > grant role -r role1 -u user1

منح امتياز

تعيين امتياز لدور ما.

بناء الجملة

grant privilege

مثال تفاعلي

milvus_cli > grant privilege

Role name: role1
The type of object for which the privilege is to be assigned. (Global, Collection, User): Collection
The name of the object to control access for: object1
The name of the privilege to assign. (CreateCollection, DropCollection, etc.): CreateCollection
The name of the database to which the object belongs. [default]: default

إبطال الدور

إبطال الدور المعين لمستخدم.

بناء الجملة

revoke role -r (text) -u (text)

الخيارات

الخيارالاسم الكاملالوصف
-r-roleNameاسم دور دور ميلفوس.
-u-اسم المستخدماسم المستخدم لمستخدم ميلفوس.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > revoke role -r role1 -u user1

إبطال امتياز

إبطال امتياز تم تعيينه مسبقاً لدور ما.

بناء الجملة

revoke privilege

مثال تفاعلي

milvus_cli > revoke privilege

Role name: role1
The type of object for which the privilege is to be assigned. (Global, Collection, User): Collection
The name of the object to control access for: object1
The name of the privilege to assign. (CreateCollection, DropCollection, etc.): CreateCollection
The name of the database to which the object belongs. [default]: default

إظهار المجموعة

إظهار المعلومات التفصيلية للمجموعة.

بناء الجملة

show collection -c (text)

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > show collection -c test_collection_insert

إظهار القسم

يعرض المعلومات التفصيلية لقسم ما.

بناء الجملة

show partition -c (text) -p (text)

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة التي ينتمي إليها القسم.
-p-قسماسم القسم.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال

milvus_cli > show partition -c test_collection_insert -p _default

إظهار الفهرس

يعرض المعلومات التفصيلية لفهرس ما.

بناء الجملة

show index -c (text) -in (text)

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة.
-في-اسم الفهرساسم الفهرس.

|-المساعدة |عرض التعليمات الخاصة باستخدام الأمر. |

مثال

milvus_cli > show index -c test_collection -in index_name

خروج

يغلق نافذة سطر الأوامر.

بناء الجملة

exit

خيارات

الخيارالاسم الكاملالوصف
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

تعليمات

يعرض تعليمات استخدام الأمر.

بناء الجملة

help <command>

الأوامر

الأمرالوصف
مسحمسح الشاشة.
الاتصاليتصل بميلفوس.
إنشاءإنشاء مجموعة وقاعدة بيانات وقسم ومستخدم ودور وفهرس.
منحمنح الدور والامتياز.
إبطالإبطال الدور والامتياز .
حذفحذف المجموعة أو قاعدة البيانات أو القسم أو الاسم المستعار أو المستخدم أو الدور أو الفهرس.
إنهاءيغلق نافذة سطر الأوامر.
تعليماتيعرض تعليمات استخدام الأمر.
إدراجيستورد البيانات إلى قسم.
قائمةسرد المجموعات أو قواعد البيانات أو الأقسام أو المستخدمين أو الأدوار أو المنح أو الفهارس.
تحميلتحميل مجموعة أو قسم.
استعلاميعرض نتائج الاستعلام التي تطابق جميع المعايير التي تقوم بإدخالها.
إصدارتحرير مجموعة أو قسم.
بحثإجراء بحث تشابه متجه أو بحث مختلط.
إظهارإظهار الاتصال أو قاعدة البيانات أو المجموعة أو التحميل_التقدم أو الفهرس_التقدم.
إعادة تسميةإعادة تسمية المجموعة
استخداماستخدام قاعدة البيانات
الإصداريعرض إصدار Milvus_CLI.

إدراج

يستورد البيانات المحلية أو البعيدة إلى قسم.

بناء الجملة

insert file -c (text) [-p (text)] [-t (text)] <file_path>

خيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة التي يتم إدراج البيانات فيها.
-p-قسم(اختياري) اسم القسم الذي يتم إدراج البيانات فيه. يشير عدم تمرير خيار القسم هذا إلى اختيار القسم "_default".
-t-مهلة(اختياري) مدة زمنية اختيارية بالثواني للسماح بإدخال طلب استدعاء الطلبات المتكررة. إذا لم يتم تعيين المهلة، يستمر العميل في الانتظار حتى يستجيب الخادم أو يحدث خطأ.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

مثال 1

يقوم المثال التالي باستيراد ملف CSV محلي.

milvus_cli > insert file -c car 'examples/import_csv/vectors.csv'

Reading csv file...  [####################################]  100%

Column names are ['vector', 'color', 'brand']

Processed 50001 lines.

Inserting ...

Insert successfully.
--------------------------  ------------------
Total insert entities:                   50000
Total collection entities:              150000
Milvus timestamp:           428849214449254403
--------------------------  ------------------

المثال 2

يستورد المثال التالي ملف CSV بعيد.

milvus_cli > insert file -c car 'https://raw.githubusercontent.com/milvus-
io/milvus_cli/main/examples/import_csv/vectors.csv'

Reading file from remote URL.

Reading csv file...  [####################################]  100%

Column names are ['vector', 'color', 'brand']

Processed 50001 lines.

Inserting ...

Insert successfully.

--------------------------  ------------------
Total insert entities:                   50000
Total collection entities:              150000
Milvus timestamp:           428849214449254403
--------------------------  ------------------

إدراج صف

إدراج صف من البيانات في مجموعة.

بناء الجملة

insert row

مثال تفاعلي

milvus_cli > insert row

Collection name: car
Partition name [_default]: _default
Enter value for id (INT64): 1
Enter value for vector (FLOAT_VECTOR): [1.0, 2.0, 3.0]
Enter value for color (INT64): 100
Enter value for brand (VARCHAR): Toyota

Inserted successfully.

قائمة المستخدمين

يسرد جميع المستخدمين.

بناء الجملة

list users

خيارات

|الخيار |الاسم الكامل |الوصف |-المساعدة |عرض التعليمات الخاصة باستخدام الأمر. |

سرد الأدوار

سرد الأدوار في ملفوس

بناء الجملة

list roles

خيارات

الخيارالاسم الكاملالوصف
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

أمثلة

milvus_cli > list roles

سرد المنح

سرد المنح في ميلفوس

الخيارات

الخيارالاسم الكاملالوصف
-r-roleNameاسم دور دور ميلفوس.
-o-اسم الكائناسم الكائن الخاص بكائن ميلفوس.
-t-نوع الكائنعام أو مجموعة أو مستخدم.
-مساعدةغير متاحيعرض تعليمات استخدام الأمر.

أمثلة

milvus_cli > list grants -r role1 -o object1 -t Collection

سرد المجموعات

سرد كافة المجموعات.

بناء الجملة

list collections

خيارات

الخيارالاسم الكاملالوصف
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

قائمة الفهارس

يسرد كافة الفهارس الخاصة بمجموعة ما.

تدعم المجموعة حاليًا فهرسًا واحدًا كحد أقصى.

بناء الجملة

list indexes -c (text)

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

سرد الأقسام

يسرد كافة أقسام المجموعة.

بناء الجملة

list partitions -c (text)

خيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

تحميل

تحميل مجموعة أو قسم من مساحة القرص الصلب إلى ذاكرة الوصول العشوائي.

بناء الجملة

load collection -c (text) [-p (text)]

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة التي ينتمي إليها القسم.
-p-قسم(اختياري/متعدد) اسم القسم.
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

استعلام

يعرض نتائج الاستعلام التي تطابق كافة المعايير التي تقوم بإدخالها.

بناء الجملة

query

مثال تفاعلي

milvus_cli > query

Collection name: car

The query expression: id in [ 428960801420883491, 428960801420883492, 428960801420883493 ]

Name of partitions that contain entities(split by "," if multiple) []: default

A list of fields to return(split by "," if multiple) []: color, brand

timeout []:

Guarantee timestamp. This instructs Milvus to see all operations performed before a provided timestamp. If no such timestamp is provided, then Milvus will search all operations performed to date. [0]:

Graceful time. Only used in bounded consistency level. If graceful_time is set, PyMilvus will use current timestamp minus the graceful_time as the guarantee_timestamp. This option is 5s by default if not set. [5]:

الإصدار

تحرير مجموعة أو قسم من ذاكرة الوصول العشوائي.

بناء الجملة

release collection -c (text) [-p (text)]

خيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة التي ينتمي إليها القسم.
-p-قسم(اختياري/متعدد) اسم القسم.
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

إجراء بحث تشابه متجه أو بحث هجين.

search

milvus_cli > search

Collection name (car, test_collection): car

The vectors of search data(the length of data is number of query (nq), the dim of every vector in data must be equal to vector field's of collection. You can also import a csv file without headers): examples/import_csv/search_vectors.csv

The vector field used to search of collection (vector): vector

Search parameter nprobe's value: 10

The max number of returned record, also known as topk: 2

The boolean expression used to filter attribute []: id > 0

The names of partitions to search (split by "," if multiple) ['_default'] []: _default

timeout []:

Guarantee Timestamp(It instructs Milvus to see all operations performed before a provided timestamp. If no such timestamp is provided, then Milvus will search all operations performed to date) [0]:

سرد الاتصالات

سرد الاتصالات.

بناء الجملة

list connections

الخيارات

الخيارالاسم الكاملالوصف
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.

إظهار تقدم الفهرسة

يعرض تقدم فهرسة الكيانات.

بناء الجملة

show index_progress -c (text) [-i (text)]

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة التي تنتمي إليها الكيانات.
-i-الفهرس(اختياري) اسم الفهرس.
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

إظهار تقدم التحميل

يعرض تقدم تحميل مجموعة ما.

بناء الجملة

show loading_progress -c (text) [-p (text)]

الخيارات

الخيارالاسم الكاملالوصف
-c-اسم المجموعةاسم المجموعة التي تنتمي إليها الكيانات.
-p-قسم(اختياري/متعدد) اسم قسم التحميل.
-مساعدةغير متوفريعرض التعليمات الخاصة باستخدام الأمر.

الإصدار

يعرض إصدار Milvus_CLI.

بناء الجملة

version

خيارات

الخيارالاسم الكاملالوصف
-مساعدةغير متوفريعرض تعليمات استخدام الأمر.
يمكنك أيضًا التحقق من إصدار Milvus_CLI في shell كما هو موضح في المثال التالي. في هذه الحالة، يعمل milvus_cli --version كأمر.

مثال

$ milvus_cli --version
Milvus_CLI v0.4.0