psql - عبر الإنترنت في السحابة

برنامج:

اسم

psql - محطة تفاعلية PostgreSQL

موجز

psql [خيار...] [com.dbname [اسم المستخدم]]

الوصف

psql هي واجهة أمامية قائمة على المحطة الطرفية لـ PostgreSQL. تمكنك من كتابة الاستفسارات
بشكل تفاعلي ، قم بإصدارها إلى PostgreSQL ، وشاهد نتائج الاستعلام. بدلا من ذلك ، المدخلات
يمكن أن يكون من ملف. بالإضافة إلى ذلك ، فإنه يوفر عددًا من الأوامر الوصفية والمتنوعة
ميزات تشبه الصدفة لتسهيل كتابة البرامج النصية وأتمتة مجموعة متنوعة من المهام.

OPTIONS

-a
- صدى الكل
طباعة كافة سطور الإدخال غير الفارغة إلى الإخراج القياسي كما تتم قراءتها. (لم يحدث ذلك
تنطبق على الأسطر التي تقرأ بشكل تفاعلي.) وهذا يعادل ضبط المتغير فحص إيكو إلى
الكل.

-A
- لا محاذاة
يبدل إلى وضع الإخراج غير المحاذاة. (يتم محاذاة وضع الإخراج الافتراضي بطريقة أخرى.)

-b
- أخطاء صدى
طباعة أوامر SQL الفاشلة لإخراج الخطأ القياسي. هذا يعادل ضبط
متغير فحص إيكو للأخطاء.

-c أمر
- الأمر =أمر
يحدد أن psql ينفذ سلسلة أوامر واحدة ، أمر، ثم الخروج. هذا هو
مفيد في البرامج النصية شل. ملفات بدء التشغيل (psqlrc و ~ / .psqlrc) مع هذا
الخيار.

أمر يجب أن يكون إما سلسلة أوامر قابلة للتحليل بالكامل بواسطة الخادم
(على سبيل المثال ، لا يحتوي على ميزات خاصة بـ psql) ، أو أمر شرطة مائلة عكسية واحدة. هكذا أنت
لا يمكن مزج أوامر SQL و psql meta مع هذا الخيار. لتحقيق ذلك ، يمكنك
قم بتوصيل السلسلة إلى psql ، على سبيل المثال: echo '\ x \\ SELECT * FROM foo؛' | بسكل. (\\ يكون
الأمر الفاصل للفاصل.)

إذا كانت سلسلة الأمر تحتوي على أوامر SQL متعددة ، فستتم معالجتها في ملف واحد
الصفقة ، ما لم يكن هناك صريح ابدأ/ارتكب الأوامر المضمنة في السلسلة إلى
تقسيمها إلى معاملات متعددة. هذا يختلف عن السلوك عندما يكون ملف
يتم تغذية نفس السلسلة إلى الإدخال القياسي لـ psql. أيضا ، فقط نتيجة آخر SQL
يتم إرجاع الأمر.

بسبب هذه السلوكيات القديمة ، فإن وضع أكثر من أمر واحد في -c سلسلة
غالبًا ما يكون له نتائج غير متوقعة. من الأفضل إطعام أوامر متعددة لمعيار psql
الإدخال ، إما باستخدام echo كما هو موضح أعلاه ، أو عبر shell here-document ، لـ
مثال:

بسكل <
\x
حدد * من فو ؛
EOF

-d com.dbname
--dbname =com.dbname
يحدد اسم قاعدة البيانات للاتصال بها. هذا يعادل التحديد
com.dbname كأول وسيطة غير اختيارية في سطر الأوامر.

إذا كانت هذه المعلمة تحتوي على علامة = أو تبدأ ببادئة URI صالحة (postgresql: //
أو postgres: //) ، يتم التعامل معها على أنها ملف كونينفو سلسلة. راجع القسم 31.1.1 ، "الاتصال
سلاسل "، في الوثائق لمزيد من المعلومات.

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

-E
- صدى مخفي
صدى الاستعلامات الفعلية التي تم إنشاؤها بواسطة \d وأوامر الخط المائل العكسي الأخرى. يمكنك استخدام هذا
لدراسة العمليات الداخلية في psql. هذا يعادل ضبط المتغير
صدى إلى يوم.

-f اسم الملف
- ملف =اسم الملف
استخدم الملف اسم الملف كمصدر للأوامر بدلاً من قراءة الأوامر
بشكل تفاعلي. بعد معالجة الملف ، ينتهي psql. هذا من نواح كثيرة
يعادل الأمر الفوقي \i.

If اسم الملف هو - (واصلة) ، ثم تتم قراءة الإدخال القياسي حتى إشارة EOF أو \q
قيادة ميتا. لاحظ مع ذلك أن Readline لا يتم استخدامه في هذه الحالة (كما لو كان -n كان
تم تحديده).

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

-F الفاصل
- فاصل الحقول =الفاصل
استعمل الفاصل كفاصل مجال للإخراج غير المحاذاة. هذا يعادل \ pset
الحقول or \f.

-h اسم المضيف
- المضيف =اسم المضيف
يحدد اسم مضيف الجهاز الذي يعمل عليه الخادم. إذا كانت القيمة
يبدأ بشرطة مائلة ، ويستخدم كدليل لمقبس مجال Unix.

-H
--لغة البرمجة
قم بتشغيل الإخراج الجدولي HTML. هذا يعادل \ pset تنسيق html أو \H
أمر.

-l
--قائمة
قائمة بجميع قواعد البيانات المتاحة ، ثم الخروج. يتم تجاهل الخيارات الأخرى غير المتصلة.
هذا مشابه للأمر الفوقي \قائمة.

-L اسم الملف
--log- ملف =اسم الملف
كتابة جميع مخرجات الاستعلام في ملف اسم الملف، بالإضافة إلى الإخراج العادي
الوجهة.

-n
--لا للقراءة
لا تستخدم Readline لتحرير السطر ولا تستخدم محفوظات الأوامر. هذا يمكن أن يكون
مفيد لإيقاف توسيع علامة التبويب عند القص واللصق.

-o اسم الملف
- الخرج =اسم الملف
ضع كل مخرجات الاستعلام في ملف اسم الملف. هذا يعادل الأمر \o.

-p ميناء
- المنفذ =ميناء
يحدد منفذ TCP أو امتداد ملف مقبس مجال Unix المحلي الذي يكون ملف
الخادم يستمع للاتصالات. افتراضات على قيمة بي جي بورت بيئة
متغير أو ، إذا لم يتم تعيينه ، إلى المنفذ المحدد في وقت الترجمة ، عادةً 5432.

-P مهمة
- قطعة =مهمة
يحدد خيارات الطباعة بأسلوب \ pset. لاحظ أنه هنا عليك الانفصال
الاسم والقيمة بعلامة يساوي بدلاً من مسافة. على سبيل المثال ، لتعيين الإخراج
إلى LaTeX ، يمكنك كتابة -P format = latex.

-q
--هادئ
يحدد أن psql يجب أن تقوم بعملها بهدوء. بشكل افتراضي ، يقوم بطباعة رسائل الترحيب
ومختلف المخرجات الإعلامية. إذا تم استخدام هذا الخيار ، فلن يحدث أي من هذا. هذه
مفيد مع -c اختيار. هذا يعادل ضبط المتغير هادئ إلى يوم.

-R الفاصل
- فاصل السجل =الفاصل
استعمل الفاصل كفاصل سجل للإخراج غير المحاذاة. هذا يعادل
\ pset السجلات أمر.

-s
- خطوة واحدة
تشغيل في وضع خطوة واحدة. هذا يعني أنه تتم مطالبة المستخدم قبل إرسال كل أمر
إلى الخادم ، مع خيار إلغاء التنفيذ أيضًا. استخدم هذا لتصحيح البرامج النصية.

-S
--سطر واحد
يعمل في وضع سطر واحد حيث ينهي سطر جديد أمر SQL ، كفاصلة منقوطة
لا.

ملاحظات
يتم توفير هذا الوضع لأولئك الذين يصرون عليه ، لكنك لست بالضرورة كذلك
شجع على استخدامه. على وجه الخصوص ، إذا قمت بخلط أوامر SQL والأوامر الوصفية على سطر
قد لا يكون ترتيب التنفيذ واضحًا دائمًا للمستخدم عديم الخبرة.

-t
- مضاعف فقط
قم بإيقاف تشغيل طباعة أسماء الأعمدة وتذييلات عدد صفوف النتائج وما إلى ذلك. هذا هو
ما يعادل \t أمر.

-T خيارات الجدول
--table-Attr =خيارات الجدول
يحدد الخيارات التي سيتم وضعها داخل علامة جدول HTML. ارى \ pset للتفاصيل.

-U اسم المستخدم
--اسم المستخدم =اسم المستخدم
اتصل بقاعدة البيانات كمستخدم اسم المستخدم بدلا من الافتراضي. (يجب أن تمتلك
إذن للقيام بذلك ، بالطبع.)

-v مهمة
- مجموعة =مهمة
- متغير =مهمة
قم بإجراء إسناد متغير ، مثل \يضع قيادة ميتا. لاحظ أنه يجب عليك الفصل
الاسم والقيمة ، إن وجدت ، بعلامة يساوي في سطر الأوامر. لإلغاء تعيين متغير ،
اترك علامة المساواة. لتعيين متغير بقيمة فارغة ، استخدم علامة التساوي
لكن اترك القيمة. تتم هذه التعيينات خلال مرحلة مبكرة جدًا من
بدء التشغيل ، لذلك قد يتم الكتابة فوق المتغيرات المحجوزة للأغراض الداخلية لاحقًا.

-V
--الإصدار
اطبع نسخة psql واخرج.

-w
--لا توجد كلمة مرور
أبدا إصدار مطالبة كلمة المرور. إذا كان الخادم يتطلب مصادقة كلمة المرور وملف
كلمة المرور غير متاحة بوسائل أخرى مثل ملف .pgpass ، الاتصال
ستفشل المحاولة. يمكن أن يكون هذا الخيار مفيدًا في المهام الدفعية والبرامج النصية التي لا يوجد فيها مستخدم
موجود لإدخال كلمة المرور.

لاحظ أن هذا الخيار سيظل معيّناً للجلسة بأكملها ، وبالتالي فإنه يؤثر على الاستخدامات
للأمر الفوقي \الاتصال بالإضافة إلى محاولة الاتصال الأولية.

-W
--كلمه السر
فرض psql للمطالبة بكلمة مرور قبل الاتصال بقاعدة البيانات.

هذا الخيار ليس ضروريًا أبدًا ، لأن psql سيطالبك تلقائيًا بكلمة مرور إذا كان
يطلب الخادم مصادقة كلمة المرور. ومع ذلك ، سوف يضيع psql الاتصال
محاولة معرفة أن الخادم يريد كلمة مرور. في بعض الحالات ، الأمر يستحق الكتابة
-W لتجنب محاولة الاتصال الإضافية.

لاحظ أن هذا الخيار سيظل معيّناً للجلسة بأكملها ، وبالتالي فإنه يؤثر على الاستخدامات
للأمر الفوقي \الاتصال بالإضافة إلى محاولة الاتصال الأولية.

-x
--موسع
قم بتشغيل وضع تنسيق الجدول الموسع. هذا يعادل \x أمر.

-X ،
--لا- psqlrc
لا تقرأ ملف بدء التشغيل (لا ملف psqlrc على مستوى النظام ولا ملف المستخدم
~ / .psqlrc الملف).

-z
- فاصل الحقل صفر
اضبط فاصل الحقل للإخراج غير المحاذي على صفر بايت.

-0
- فاصل سجل صفر
اضبط فاصل السجل للإخراج غير المحاذي على صفر بايت. هذا مفيد ل
التواصل ، على سبيل المثال ، مع xargs -0.

-1
- صفقة واحدة
عندما ينفذ psql نصًا ، فإن إضافة هذا الخيار تلتف ابدأ/ارتكب حول النص
لتنفيذه كمعاملة واحدة. هذا يضمن إما أن جميع الأوامر
اكتمل بنجاح ، أو لم يتم تطبيق أي تغييرات.

إذا كان البرنامج النصي نفسه يستخدم ابدأ, ارتكب أو رول باك، لن يحتوي هذا الخيار على الامتداد
التأثيرات المرغوبة. أيضًا ، إذا كان البرنامج النصي يحتوي على أي أمر لا يمكن تنفيذه
داخل كتلة معاملة ، سيؤدي تحديد هذا الخيار إلى ظهور هذا الأمر (وبالتالي
المعاملة بأكملها) بالفشل.

-?
- مساعدة [=موضوع]
إظهار المساعدة حول psql والخروج. اختياري موضوع المعلمة (الافتراضي إلى الخيارات)
يختار الجزء الموضح من psql: تصف الأوامر أوامر psql's backslash ؛
تصف الخيارات خيارات سطر الأوامر التي يمكن تمريرها إلى psql ؛ والمتغيرات
يظهر تعليمات حول متغيرات تكوين psql.

EXIT الوضع

يُرجع psql القيمة 0 إلى الغلاف إذا انتهى بشكل طبيعي ، 1 إذا حدث خطأ فادح من تلقاء نفسه
(على سبيل المثال نفاد الذاكرة ، الملف غير موجود) ، 2 إذا كان الاتصال بالخادم سيئًا وكان ملف
لم تكن الجلسة تفاعلية ، و 3 إذا حدث خطأ في البرنامج النصي والمتغير
ON_ERROR_STOP تم تعيين.

الاستعمال

الرابط إلى a قاعدة البيانات
psql هو تطبيق عميل PostgreSQL عادي. من أجل الاتصال بقاعدة بيانات لك
بحاجة إلى معرفة اسم قاعدة البيانات الهدف واسم المضيف ورقم المنفذ الخاص بـ
الخادم ، وما هو اسم المستخدم الذي تريد الاتصال به. يمكن أن يقال عن هؤلاء psql
المعلمات عبر خيارات سطر الأوامر ، وهي -d, -h, -pو -U على التوالى. إذا كان
تم العثور على حجة لا تنتمي إلى أي خيار سيتم تفسيره على أنه
اسم قاعدة البيانات (أو اسم المستخدم ، إذا تم تقديم اسم قاعدة البيانات بالفعل). ليس كل هؤلاء
الخيارات مطلوبة ؛ هناك افتراضات مفيدة. إذا حذفت اسم المضيف ، فسيقوم psql
الاتصال عبر مقبس مجال Unix بخادم على المضيف المحلي ، أو عبر TCP / IP إلى المضيف المحلي
على الأجهزة التي لا تحتوي على مآخذ بنطاق Unix. يتم تحديد رقم المنفذ الافتراضي عند
وقت الترجمة. نظرًا لأن خادم قاعدة البيانات يستخدم نفس الإعداد الافتراضي ، فلن تضطر إلى ذلك
تحديد المنفذ في معظم الحالات. اسم المستخدم الافتراضي هو اسم مستخدم نظام التشغيل الخاص بك ،
كما هو اسم قاعدة البيانات الافتراضي. لاحظ أنه لا يمكنك فقط الاتصال بأي قاعدة بيانات ضمن
أي اسم مستخدم. يجب أن يكون مسؤول قاعدة البيانات قد أبلغك بوصولك
حقوق.

عندما لا تكون الإعدادات الافتراضية صحيحة تمامًا ، يمكنك توفير بعض الكتابة عن طريق تعيين ملف
متغيرات البيئة قاعدة بيانات PG, شبح, بي جي بورت و / أو PGUSER للقيم المناسبة. (ل
متغيرات البيئة الإضافية ، راجع القسم 31.14 ، "متغيرات البيئة" ، في
الوثائق.) ومن الملائم أيضًا أن يكون لديك ملف ~ / .pgpass ملف لتجنب وجود ملفات
لكتابة كلمات المرور. راجع القسم 31.15 ، "ملف كلمة المرور" ، في وثائق
معلومات اكثر.

هناك طريقة بديلة لتحديد معلمات الاتصال في ملف كونينفو سلسلة أو URI ،
والذي يتم استخدامه بدلاً من اسم قاعدة البيانات. تمنحك هذه الآلية سيطرة واسعة جدًا عليها
الاتصال. على سبيل المثال:

$ psql "الخدمة = myservice sslmode = تتطلب "
$ psql postgresql: // dbmaster: 5433 / mydb؟ sslmode = تتطلب

بهذه الطريقة يمكنك أيضًا استخدام LDAP للبحث عن معلمات الاتصال كما هو موضح في القسم
31.17 ، "LDAP Lookup of Connection Parameters" ، في الوثائق. انظر القسم 31.1.2 ،
“Parameter Key Words” ، في الوثائق لمزيد من المعلومات حول كل ما هو متاح
خيارات الاتصال.

إذا تعذر إجراء الاتصال لأي سبب (على سبيل المثال ، امتيازات غير كافية ، الخادم
لا يعمل على المضيف المستهدف ، وما إلى ذلك) ، فسيرجع psql خطأ وينتهي.

إذا كان كل من الإدخال القياسي والمخرج القياسي عبارة عن محطة طرفية ، فسيقوم psql بتعيين العميل
الترميز إلى "تلقائي" ، والذي سيكتشف تشفير العميل المناسب من الإعدادات المحلية
الإعدادات (LC_CTYPE متغير البيئة في أنظمة Unix). إذا كان هذا لا يعمل بها
من المتوقع ، يمكن تجاوز ترميز العميل باستخدام متغير البيئة
الترميز PGCLIENTENCODING.

الدخول SQL أوامر
في التشغيل العادي ، يوفر psql موجهًا باسم قاعدة البيانات التي تنتمي إليها psql
متصل حاليًا ، متبوعًا بالسلسلة =>. على سبيل المثال:

$ psql com.testdb
بسكل (9.5.2)
اكتب "تعليمات" للحصول على المساعدة.

testdb =>

في موجه الأوامر ، يمكن للمستخدم كتابة أوامر SQL. عادة ، يتم إرسال سطور الإدخال إلى
الخادم عند الوصول إلى فاصلة منقوطة إنهاء الأمر. لا تنتهي نهاية السطر
أمر. وهكذا يمكن أن تنتشر الأوامر على عدة أسطر من أجل الوضوح. إذا كان الأمر
تم إرسالها وتنفيذها بدون أخطاء ، يتم عرض نتائج الأمر على الشاشة.

عند تنفيذ أمر ما ، يستقصي psql أيضًا أحداث الإعلام غير المتزامنة
ولدت من قبل الاستماع(7) و إعلام(7).

بينما يتم تمرير تعليقات كتلة النمط C إلى الخادم للمعالجة والإزالة ،
يتم إزالة تعليقات SQL القياسية بواسطة psql.

أوامر ميتا
أي شيء تدخله في psql يبدأ بشرطة مائلة عكسية غير مسعرة هو أمر meta-psql
التي تتم معالجتها بواسطة psql نفسها. هذه الأوامر تجعل psql أكثر فائدة للإدارة
أو البرمجة النصية. غالبًا ما تسمى أوامر التعريف بأوامر الشرطة المائلة أو المائلة العكسية.

تنسيق الأمر psql هو الشرطة المائلة للخلف ، متبوعة مباشرة بفعل الأمر ،
ثم أية حجج. يتم فصل الوسيطات عن فعل الأمر وعن بعضها البعض بواسطة
أي عدد من أحرف المسافات البيضاء.

لتضمين مسافة بيضاء في وسيطة ، يمكنك اقتباسها بعلامات اقتباس مفردة. لتضمين أ
اقتباس واحد في حجة ، اكتب علامتي اقتباس فرديتين داخل نص مقتبس منفردة. اى شى
المضمنة في علامات الاقتباس المفردة تخضع علاوة على ذلك لاستبدالات تشبه C لـ \ n (جديد
سطر) ، \ t (علامة تبويب) ، \ b (مسافة للخلف) ، \ r (إرجاع السطر) ، \ f (نموذج التغذية) ، \الأرقام (ثماني) ،
و \ xالأرقام (السداسي عشري). شرطة مائلة للخلف تسبق أي حرف آخر داخل علامة اقتباس مفردة
يقتبس النص هذا الحرف الفردي ، مهما كان.

داخل وسيطة ، يتم أخذ النص المحاط بعلامات الاقتباس الخلفية (`) كسطر أوامر
التي يتم تمريرها إلى القشرة. إخراج الأمر (مع إزالة أي سطر جديد لاحق)
يستبدل النص المنقوش.

إذا ظهرت علامة النقطتين غير المقتبسة (:) متبوعة باسم متغير psql داخل وسيطة ، فسيتم ذلك
يتم استبداله بقيمة المتغير ، كما هو موضح في SQL Interpolation.

تأخذ بعض الأوامر معرّف SQL (مثل اسم الجدول) كوسيطة. هذه الحجج
اتبع قواعد بناء جملة SQL: تُجبر الأحرف غير المقتبسة على الأحرف الصغيرة ، بينما الأحرف المزدوجة
علامات الاقتباس (") تحمي الحروف من تحويل الحالة وتسمح بدمج المسافات البيضاء فيها
المعرف. ضمن علامات الاقتباس المزدوجة ، يتم تقليل علامات الاقتباس المزدوجة إلى عرض أسعار مزدوج واحد
في الاسم الناتج. على سبيل المثال ، يتم تفسير FOO "BAR" BAZ على أنه fooBARbaz و "A
"" اسم "غريب يصبح اسمًا غريبًا.

يتوقف التحليل اللغوي للوسيطات في نهاية السطر ، أو عندما تكون شرطة مائلة عكسية أخرى غير مسعرة
وجدت. يتم أخذ الخط المائل العكسي غير المقتبس كبداية لأمر meta جديد. الخاص
يشير التسلسل \\ (شرطان مائلان عكسيان) إلى نهاية الوسيطات ويستمر في تحليل SQL
الأوامر ، إن وجدت. بهذه الطريقة يمكن خلط أوامر SQL و psql بحرية على سطر. ولكن في أي
الحالة ، لا يمكن أن تستمر وسيطات الأمر meta إلى ما بعد نهاية السطر.

يتم تحديد أوامر التعريف التالية:

\a
إذا كان تنسيق إخراج الجدول الحالي غير محاذٍ ، يتم تبديله إلى المحاذاة. اذا كانت
غير محاذي ، تم ضبطه على عدم المحاذاة. يتم الاحتفاظ بهذا الأمر للخلف
التوافق. ارى \ pset لحل أكثر عمومية.

\ ج أو \ الاتصال [ com.dbname [ اسم المستخدم ] [ مضيف ] [ ميناء ]] | كونينفو
ينشئ اتصالاً جديدًا بخادم PostgreSQL. معلمات الاتصال لاستخدامها
يمكن تحديدها إما باستخدام صيغة موضعية ، أو باستخدام اتصال conninfo
السلاسل كما هو مفصل في القسم 31.1.1 ، "سلاسل الاتصال" ، في الوثائق.

عند استخدام المعلمات الموضعية ، إن وجدت com.dbname, اسم المستخدم, مضيف or ميناء تم حذفها
أو يتم تحديدها كـ - ، يتم استخدام قيمة تلك المعلمة من الاتصال السابق ؛
إذا لم يكن هناك اتصال سابق ، فإن القيمة الافتراضية libpq لقيمة المعلمة هي
تستخدم. عند استخدام سلاسل conninfo ، لا يتم استخدام أي قيم من الاتصال السابق لـ
الاتصال الجديد.

إذا تم إجراء الاتصال الجديد بنجاح ، فسيتم إغلاق الاتصال السابق. إذا كان
فشلت محاولة الاتصال (اسم مستخدم خاطئ ، رفض الوصول ، إلخ) ، السابق
سيتم الاحتفاظ بالاتصال فقط إذا كان psql في الوضع التفاعلي. عند تنفيذ أ
نص برمجي غير تفاعلي ، ستتوقف المعالجة فورًا مع حدوث خطأ. هذه
تم اختيار التمييز كوسيلة راحة للمستخدم ضد الأخطاء المطبعية من ناحية ، و
آلية الأمان التي لا تعمل البرامج النصية بطريق الخطأ على قاعدة البيانات الخاطئة على
يد أخرى.

أمثلة:

=> \ c mydb myuser host.dom 6432
=> \ c service = foo
=> \ c "host = localhost port = 5432 dbname = mydb connect_timeout = 10 sslmode = تعطيل"
=> \ c postgresql: // tom @ localhost / mydb؟ application_name = myapp

\ C [ الاسم ]
يعيّن عنوان أي جداول تتم طباعتها كنتيجة لاستعلام أو إلغاء تعيين أي من هذه الجداول
لقب. هذا الأمر يعادل \ pset title الاسم. (اسم هذا الأمر
مشتق من "التسمية التوضيحية" ، حيث تم استخدامه في السابق فقط لتعيين التسمية التوضيحية في HTML
الطاولة.)

\ قرص مضغوط [ دليل ]
يغير دليل العمل الحالي إلى دليل. بدون جدال ، يتغير إلى
الدليل الرئيسي للمستخدم الحالي.

نصيحه
لطباعة دليل العمل الحالي ، استخدم \! pwd.

\ conninfo
إخراج معلومات حول اتصال قاعدة البيانات الحالي.

\ينسخ { جدول [( column_list )] | ( سؤال )} {من | إلى } { 'اسم الملف' | برنامج
'أمر' | stdin | stdout | pstdin | pstdout} [[مع] ( خيار [، ...])]
ينفذ نسخة الواجهة الأمامية (العميل). هذه عملية تدير SQL COPY(7)
الأمر ، ولكن بدلاً من قراءة الخادم للملف المحدد أو كتابته ، يقرأ psql
أو يكتب الملف ويوجه البيانات بين الخادم ونظام الملفات المحلي.
هذا يعني أن إمكانية الوصول إلى الملفات وامتيازاتها تخص المستخدم المحلي ، وليس ملف
الخادم ، وليس هناك حاجة إلى امتيازات مستخدم SQL المتميز.

عندما يتم تحديد البرنامج ، أمر يتم تنفيذه بواسطة psql ويتم تمرير البيانات من أو إلى
أمر يتم توجيهها بين الخادم والعميل. مرة أخرى ، امتيازات التنفيذ
هي تلك الخاصة بالمستخدم المحلي ، وليس الخادم ، ولا توجد امتيازات مستخدم SQL المتميز
مطلوب.

بالنسبة لـ \ copy ... from stdin ، تتم قراءة صفوف البيانات من نفس المصدر الذي أصدر ملف
الأمر ، يستمر حتى \. تمت قراءته أو وصول الدفق إلى EOF. هذا الخيار مفيد
لتعبئة الجداول في السطر داخل ملف نصي SQL. لنسخ ... إلى stdout ،
يتم إرسال الإخراج إلى نفس المكان مثل إخراج الأمر psql ، والنسخة عد أمر
لم تتم طباعة الحالة (حيث قد يتم الخلط بينها وبين صف البيانات). للقراءة / الكتابة
إدخال أو إخراج psql القياسي بغض النظر عن مصدر الأمر الحالي أو \ o الخيار ،
اكتب من pstdin أو إلى pstdout.

يشبه بناء جملة هذا الأمر صيغة SQL COPY(7) الأمر. كل الخيارات
بخلاف مصدر البيانات / الوجهة المحددة لها COPY(7). و لهذا،
تنطبق قواعد الإعراب الخاصة على \ينسخ أمر. على وجه الخصوص ، متغير psql
لا تنطبق قواعد الاستبدال وعمليات الهروب بالخط المائل العكسي.

نصيحه
هذه العملية ليست فعالة مثل SQL COPY الأمر لأن جميع البيانات يجب أن
تمر عبر اتصال العميل / الخادم. لكميات كبيرة من البيانات SQL
قد يكون الأمر هو الأفضل.

\حقوق النشر
يعرض حقوق النشر وشروط التوزيع الخاصة بـ PostgreSQL.

\ d [S +] [ النمط ]
لكل علاقة (جدول ، عرض ، فهرس ، تسلسل ، أو جدول خارجي) أو نوع مركب
مطابقة النمط، إظهار كافة الأعمدة وأنواعها ومساحة الجدول (إذا لم يكن ملف
افتراضي) وأية سمات خاصة مثل NOT NULL أو الإعدادات الافتراضية. الفهارس المرتبطة
يتم أيضًا عرض القيود والقواعد والمحفزات. بالنسبة للجداول الخارجية ، فإن الملف المرتبط
يتم عرض الخادم الأجنبي أيضًا. (يتم تعريف "مطابقة النمط" في الأنماط
أدناه).

بالنسبة لبعض أنواع العلاقات ، يُظهر \ d معلومات إضافية لكل عمود: عمود
قيم التسلسلات والتعبير المفهرس للفهارس وخيارات غلاف البيانات الأجنبية
للطاولات الأجنبية.

صيغة الأمر \ d + متطابقة ، فيما عدا أنه يتم عرض المزيد من المعلومات: أي
يتم عرض التعليقات المرتبطة بأعمدة الجدول ، كما هو الحال مع وجود
معرفات الكائن في الجدول ، تعريف طريقة العرض إذا كانت العلاقة طريقة عرض ، وهي طريقة غير افتراضية
إعداد هوية طبق الأصل.

بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ توفير نمط أو معدل S إلى
تشمل كائنات النظام.

ملاحظات
If \d يستخدم بدون ملف النمط حجة ، وهو ما يعادل \ dtvsE والتي سوف
إظهار قائمة بجميع الجداول المرئية وطرق العرض والتسلسلات والجداول الخارجية. هذا هو
محض إجراء راحة.

\ da [S] [ النمط ]
يسرد الدالات التجميعية ، مع نوع الإرجاع وأنواع البيانات الخاصة بهم
بدأ العملية. لو النمط محددًا ، فقط المجاميع التي تتطابق أسماؤها مع النمط هي
مبين. بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ توفير نمط أو S.
معدل لتضمين كائنات النظام.

\ ديسيبل [+] [ النمط ]
يسرد مساحات الجداول. لو النمط محددًا ، فقط مساحات الجداول التي تتطابق أسماؤها مع
يتم عرض النمط. إذا تم إلحاق + باسم الأمر ، فسيتم إدراج كل مساحة جدول
مع الخيارات المرتبطة بها وحجم القرص والأذونات والوصف.

\ دس [S +] [ النمط ]
يسرد التحويلات بين ترميزات مجموعة الأحرف. لو النمط محدد فقط
يتم سرد التحويلات التي تتطابق أسماؤها مع النمط. بشكل افتراضي ، يتم إنشاء ملفات
يتم عرض الأشياء ؛ توفير نمط أو معدل S لتضمين كائنات النظام. إذا +
يتم إلحاقه باسم الأمر ، يتم سرد كل كائن مع المرتبط به
وصف.

\ dC [+] [ النمط ]
قوائم يلقي نوع. لو النمط محدد ، فقط يلقي أنواع مصدرها أو هدفها
تطابق النمط المدرجة. إذا تم إلحاق + باسم الأمر ، فسيتم إضافة كل كائن
المدرجة مع الوصف المرتبط بها.

\ dd [S] [ النمط ]
يعرض أوصاف كائنات من نوع القيد ، فئة المشغل ، عائلة المشغل ،
القاعدة ، والزناد. يمكن عرض جميع التعليقات الأخرى بواسطة الشرطة المائلة للخلف ذات الصلة
أوامر لأنواع الكائنات هذه.

\ dd يعرض أوصافًا للكائنات المطابقة لـ النمط، أو من الأشياء المرئية من
النوع المناسب إذا لم يتم إعطاء وسيطة. ولكن في كلتا الحالتين ، فقط الأشياء التي
لديك وصف مدرجة. بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ إمداد
نمط أو معدل S لتضمين كائنات النظام.

يمكن إنشاء أوصاف الكائنات باستخدام الامتداد التعليق(7) أمر SQL.

\ ddp [ النمط ]
يسرد إعدادات امتياز الوصول الافتراضية. يتم عرض إدخال لكل دور (ومخطط ،
إن أمكن) التي تم تغيير إعدادات الامتياز الافتراضية الخاصة بها من
افتراضات مضمنة. لو النمط محدد ، فقط الإدخالات التي يكون اسم دورها أو مخططها
اسم يطابق النمط مدرج.

الامتيازات البديلة (ALTER_DEFAULT_PRIVILEGES(7)) يتم استخدام الأمر لضبط
امتيازات الوصول الافتراضية. يتم شرح معنى عرض الامتياز تحت
منحة(7).

\ dD [S +] [ النمط ]
يسرد المجالات. لو النمط محددًا ، فقط المجالات التي تتطابق أسماؤها مع النمط
مبين. بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ توفير نمط أو S.
معدل لتضمين كائنات النظام. إذا تم إلحاق + باسم الأمر ، كل كائن
مدرج مع الأذونات والوصف المقترنين به.

\ dE [S +] [ النمط ]
\ دي [S +] [ النمط ]
\ dm [S +] [ النمط ]
\ ds [S +] [ النمط ]
\ dt [S +] [ النمط ]
\ dv [S +] [ النمط ]
في هذه المجموعة من الأوامر ، تشير الأحرف E و i و m و s و t و v إلى الجدول الأجنبي ،
الفهرس ، والعرض الفعلي ، والتسلسل ، والجدول ، والعرض ، على التوالي. يمكنك تحديد أي
أو كل هذه الحروف ، بأي ترتيب ، للحصول على قائمة بأشياء من هذه الأنواع.
على سبيل المثال ، يسرد \ dit الفهارس والجداول. إذا تم إلحاق + باسم الأمر ، فكل منهما
يتم سرد الكائن بحجمه الفعلي على القرص والوصف المرتبط به ، إذا كان
أي. لو النمط محددًا ، يتم سرد الكائنات التي تطابق أسماؤها النمط فقط.
بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ توفير نمط أو معدل S إلى
تشمل كائنات النظام.

\ des [+] [ النمط ]
يسرد الخوادم الأجنبية (ذاكري: "الخوادم الخارجية"). لو النمط محدد فقط
يتم سرد تلك الخوادم التي يتطابق اسمها مع النمط. إذا تم استخدام النموذج \ des + ، أ
يتم عرض الوصف الكامل لكل خادم ، بما في ذلك قائمة التحكم بالوصول الخاصة بالخادم ، والنوع ، والإصدار ،
الخيارات والوصف.

\ det [+] [ النمط ]
يسرد الجداول الأجنبية (ذاكري: "الجداول الخارجية"). لو النمط محدد فقط
يتم سرد الإدخالات التي يتطابق اسم الجدول أو اسم المخطط الخاص بها مع النمط. إذا كان النموذج
يتم استخدام \ det + ، كما يتم عرض الخيارات العامة ووصف الجدول الأجنبي.

\ deu [+] [ النمط ]
يسرد تعيينات المستخدم (ذاكري: "المستخدمون الخارجيون"). لو النمط محدد ، فقط هؤلاء
يتم سرد التعيينات التي تطابق أسماء المستخدمين الخاصة بها النمط. إذا تم استخدام النموذج \ deu + ،
يتم عرض معلومات إضافية حول كل تعيين.

الحذر
قد يعرض \ deu + أيضًا اسم المستخدم وكلمة المرور للمستخدم البعيد ، لذا اهتم
يجب عدم الكشف عنها.

\ ندى [+] [ النمط ]
يسرد أغلفة البيانات الأجنبية (ذاكري: "أغلفة خارجية"). لو النمط محدد،
يتم سرد أغلفة البيانات الأجنبية التي يتطابق اسمها مع النمط فقط. إذا كان
يتم استخدام النموذج \ dew + ، قائمة التحكم بالوصول (ACL) والخيارات ووصف غلاف البيانات الأجنبية
يظهر أيضا.

\ df [antwS +] [ النمط ]
يسرد الدالات ، جنبًا إلى جنب مع الوسائط وأنواع الإرجاع وأنواع الوظائف ،
والتي تم تصنيفها على أنها "agg" (إجمالي) أو "عادي" أو "مشغل" أو "نافذة". إلى
عرض وظائف من نوع (أنواع) معينة فقط ، أضف الأحرف المقابلة a ، أو n ، أو t ، أو
w للأمر. لو النمط محددًا ، فقط الوظائف التي تتطابق أسماؤها مع
يتم عرض النمط. بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ توفير نمط
أو المُعدِّل S لتضمين كائنات النظام. إذا تم استخدام النموذج \ df + ، فسيتم إضافة
يتم عرض معلومات حول كل وظيفة ، بما في ذلك تصنيف الأمان ،
التقلب والمالك واللغة وكود المصدر والوصف.

نصيحه
للبحث عن دالات تأخذ وسيطات أو إرجاع قيم من نوع معين ، استخدم
إمكانية البحث بجهاز النداء الخاص بك للتمرير عبر إخراج \ df.

\ dF [+] [ النمط ]
يسرد تكوينات البحث عن النص. لو النمط فقط التكوينات التي
يتم عرض الأسماء التي تتطابق مع النمط. إذا تم استخدام النموذج \ dF + ، فسيكون وصفًا كاملاً لـ
يتم عرض كل تكوين ، بما في ذلك المحلل اللغوي للبحث عن النص الأساسي و
قائمة القاموس لكل نوع رمز مميز للمحلل.

\ dFd [+] [ النمط ]
يسرد قواميس البحث عن النص. لو النمط محدد ، فقط القواميس التي أسماؤها
تطابق النمط المعروضة. إذا تم استخدام النموذج \ dFd + ، فإن المعلومات الإضافية هي
معروض حول كل قاموس محدد ، بما في ذلك قالب البحث عن النص الأساسي
وقيم الخيار.

\ dFp [+] [ النمط ]
يسرد محللي البحث عن النص. لو النمط محددًا ، المحللون الذين تتطابق أسماؤهم مع
يتم عرض النمط. إذا تم استخدام النموذج \ dFp + ، فسيكون الوصف الكامل لكل محلل
معروض ، بما في ذلك الوظائف الأساسية وقائمة أنواع الرموز المميزة المعترف بها.

\ dFt [+] [ النمط ]
يسرد قوالب البحث عن النص. لو النمط محددًا ، فقط القوالب التي تتطابق أسماؤها
يتم عرض النمط. إذا تم استخدام النموذج \ dFt + ، يتم عرض معلومات إضافية
حول كل قالب ، بما في ذلك أسماء الوظائف الأساسية.

\ dg [+] [ النمط ]
يسرد أدوار قاعدة البيانات. (منذ أن تم توحيد مفهومي "المستخدمين" و "المجموعات"
إلى "الأدوار" ، فإن هذا الأمر يعادل الآن \ du.) If النمط محدد فقط
يتم سرد تلك الأدوار التي تتطابق أسماؤها مع النمط. إذا تم استخدام النموذج \ dg + ،
يتم عرض معلومات إضافية حول كل دور ؛ حاليا هذا يضيف التعليق ل
كل دور.

\ دل
هذا هو الاسم المستعار ل \ lo_list، والذي يعرض قائمة بالأشياء الكبيرة.

\ dL [S +] [ النمط ]
يسرد اللغات الإجرائية. لو النمط محدد ، فقط اللغات التي تتطابق أسماؤها
يتم سرد النمط. بشكل افتراضي ، يتم عرض اللغات التي أنشأها المستخدم فقط ؛ توريد ال
معدل S لتضمين كائنات النظام. إذا تم إلحاق + باسم الأمر ، فكل منهما
يتم سرد اللغة مع معالج الاتصال والمدقق وامتيازات الوصول وما إذا كانت
هو كائن نظام.

\ dn [S +] [ النمط ]
يسرد المخططات (مساحات الأسماء). لو النمط محدد ، فقط المخططات التي تتطابق أسماؤها
يتم سرد النمط. بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ توريد أ
نمط أو معدل S لتضمين كائنات النظام. إذا تم إلحاق + بالأمر
الاسم ، يتم سرد كل كائن مع الأذونات والوصف المرتبطة به ، إن وجدت.

\ تفعل [S +] [ النمط ]
يسرد عوامل التشغيل بأنواع المعامل والنتائج الخاصة بهم. لو النمط محدد فقط
يتم سرد العوامل التي تتطابق أسماؤها مع النمط. بشكل افتراضي ، يتم إنشاء ملفات
يتم عرض الأشياء ؛ توفير نمط أو معدل S لتضمين كائنات النظام. إذا +
يتم إلحاقه باسم الأمر ، وتظهر معلومات إضافية حول كل مشغل ،
حاليا فقط اسم الوظيفة الأساسية.

\ dO [S +] [ النمط ]
قوائم الترتيب. لو النمط محددًا ، فقط النسخ التي تتطابق أسماؤها مع
يتم سرد النمط. بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ توفير نمط
أو المُعدِّل S لتضمين كائنات النظام. إذا تم إلحاق + باسم الأمر ،
يتم سرد كل ترتيب مع الوصف المرتبط به ، إن وجد. لاحظ ذلك فقط
يتم عرض عمليات الترتيب التي يمكن استخدامها مع ترميز قاعدة البيانات الحالية ، لذا قد تظهر النتائج
تختلف في قواعد البيانات المختلفة لنفس التثبيت.

\ dp [ النمط ]
يسرد الجداول وطرق العرض والتسلسلات مع امتيازات الوصول المرتبطة بها. لو النمط
محددًا ، يتم فقط تحديد الجداول وطرق العرض والتسلسلات التي تتطابق أسماؤها مع النمط
المدرجة.

ال منحة(7) و سحب او إبطال(7) يتم استخدام الأوامر لتعيين امتيازات الوصول. معنى
يتم شرح عرض الامتياز ضمن منحة(7).

\ درس [ نمط الدور [ نمط قاعدة البيانات ]]
يسرد إعدادات التكوين المحددة. يمكن أن تكون هذه الإعدادات خاصة بالأدوار ،
خاص بقاعدة البيانات أو كليهما. نمط الدور و نمط قاعدة البيانات تستخدم للاختيار
أدوار وقواعد بيانات محددة لإدراجها ، على التوالي. إذا تم حذفه ، أو إذا تم تحديد * ،
يتم سرد جميع الإعدادات ، بما في ذلك الإعدادات غير الخاصة بالدور أو الخاصة بقاعدة البيانات ،
على التوالي.

الدور البديل (ALTER_ROLE(7)) وتغيير قاعدة البيانات (ALTER_DATABASE(7)) الأوامر
تستخدم لتحديد إعدادات التكوين لكل دور ولكل قاعدة بيانات.

\ dT [S +] [ النمط ]
يسرد أنواع البيانات. لو النمط محدد ، فقط الأنواع التي تتطابق أسماؤها مع النمط
مدرجة. إذا تم إلحاق + باسم الأمر ، فسيتم إدراج كل نوع مع اسم الأمر
الاسم الداخلي والحجم ، والقيم المسموح بها إذا كان من نوع التعداد ، والمرتبطة به
أذونات. بشكل افتراضي ، يتم عرض الكائنات التي تم إنشاؤها بواسطة المستخدم فقط ؛ توفير نمط أو
معدل S لتضمين كائنات النظام.

\ du [+] [ النمط ]
يسرد أدوار قاعدة البيانات. (منذ أن تم توحيد مفهومي "المستخدمين" و "المجموعات"
إلى "الأدوار" ، فهذا الأمر يعادل الآن \ dg.) إذا النمط محدد فقط
يتم سرد تلك الأدوار التي تتطابق أسماؤها مع النمط. إذا تم استخدام النموذج \ du + ،
يتم عرض معلومات إضافية حول كل دور ؛ حاليا هذا يضيف التعليق ل
كل دور.

\ dx [+] [ النمط ]
يسرد الملحقات المثبتة. لو النمط محدد ، فقط تلك الامتدادات التي أسماؤها
تطابق النمط المدرجة. إذا تم استخدام النموذج \ dx + ، فإن جميع الكائنات تنتمي إلى
يتم سرد كل ملحق مطابق.

\ dy [+] [ النمط ]
يسرد الأحداث المشغلة. لو النمط محددًا ، فقط تلك الأحداث التي تطلق أسماءها
تطابق النمط المدرجة. إذا تم إلحاق + باسم الأمر ، فسيتم إضافة كل كائن
المدرجة مع الوصف المرتبط بها.

\ e أو \ تحرير [ اسم الملف ] [ رقم السطر ]
If اسم الملف محدد ، يتم تحرير الملف ؛ بعد خروج المحرر ، يكون محتواه
نسخها مرة أخرى إلى مخزن الاستعلام المؤقت. إذا كان الجواب لا اسم الملف معطى ، المخزن المؤقت للاستعلام الحالي هو
نسخها إلى ملف مؤقت ثم يتم تحريرها بنفس الطريقة.

يتم بعد ذلك إعادة تحليل المخزن المؤقت للاستعلام الجديد وفقًا للقواعد العادية لـ psql ، حيث
يتم التعامل مع المخزن المؤقت بالكامل كسطر واحد. (وبالتالي لا يمكنك عمل نصوص بهذه الطريقة.
استعمل \i لذلك). وهذا يعني أنه إذا انتهى الاستعلام بـ (أو يحتوي) على فاصلة منقوطة ، فإنه
على الفور. وإلا فإنه سينتظر فقط في المخزن المؤقت للاستعلام ؛ نوع
فاصلة منقوطة أو \ g لإرسالها ، أو \ r للإلغاء.

إذا تم تحديد رقم سطر ، فسيضع psql المؤشر على السطر المحدد من
الملف أو الاستعلام المخزن المؤقت. لاحظ أنه إذا تم تقديم وسيطة واحدة من جميع الأرقام ، psql
يفترض أنه رقم سطر وليس اسم ملف.

نصيحه
انظر أسفل "البيئة" للتعرف على كيفية تكوين المحرر الخاص بك وتخصيصه.

\صدى صوت نص [...]
يطبع الوسيطات إلى الإخراج القياسي ، مفصولة بمسافة واحدة ويتبعها ملف
خط جديد. يمكن أن يكون هذا مفيدًا لتداخل المعلومات في إخراج البرامج النصية. ل
مثال:

=> \صدى صوت "التاريخ"
الثلاثاء 26 تشرين الأول (أكتوبر) ، 21:40:57 بتوقيت وسط أوروبا الصيفي 1999

إذا كانت الوسيطة الأولى غير مسعرة ، فلن تتم كتابة السطر الجديد اللاحق.

نصيحه
إذا كنت تستخدم \o أمر لإعادة توجيه ناتج الاستعلام الذي قد ترغب في استخدامه
\ qecho بدلا من هذا الأمر.

\ ef [ وصف_الوظيفة [ رقم السطر ]]
يجلب هذا الأمر ويحرر تعريف الوظيفة المسماة ، في شكل ملف
خلق OR استبدال FUNCTION أمر. يتم التحرير بنفس طريقة التحرير.
بعد انتهاء المحرر ينتظر الأمر المحدث في المخزن المؤقت للاستعلام؛ اكتب فاصلة منقوطة
أو \ g لإرسالها ، أو \ r للإلغاء.

يمكن تحديد الوظيفة الهدف بالاسم وحده ، أو بالاسم والوسيطات من أجل
مثال foo (عدد صحيح ، نص). يجب إعطاء أنواع الوسيطات إذا كان هناك أكثر من واحد
وظيفة بنفس الاسم.

إذا لم يتم تحديد وظيفة ، فسيكون فارغًا خلق FUNCTION تم تقديم النموذج لـ
التحرير.

إذا تم تحديد رقم سطر ، فسيضع psql المؤشر على السطر المحدد من
وظيفة الجسم. (لاحظ أن جسم الوظيفة لا يبدأ عادةً في الأول
سطر من الملف.)

نصيحه
انظر أسفل "البيئة" للتعرف على كيفية تكوين المحرر الخاص بك وتخصيصه.

\التشفير [ ترميز ]
يضبط ترميز مجموعة أحرف العميل. بدون جدال ، يُظهر هذا الأمر امتداد الملف
الترميز الحالي.

\F [ سلسلة ]
يضبط فاصل الحقل لإخراج الاستعلام غير المحاذي. الافتراضي هو الشريط العمودي
(|). أنظر أيضا \ pset للحصول على طريقة عامة لتحديد خيارات الإخراج.

\ ز [ اسم الملف ]
\ ز [|أمر ]
يرسل مخزن إدخال الاستعلام الحالي إلى الخادم ، ويخزن طلب البحث اختياريًا
الإخراج في اسم الملف أو توجيه الإخراج إلى أمر shell أمر. الملف أو
يتم كتابة الأمر إلى فقط إذا كان الاستعلام يُرجع بنجاح صفرًا أو أكثر من المجموعات ، وليس
إذا فشل الاستعلام أو كان أمر SQL لا يقوم بإرجاع البيانات.

bare \ g يكافئ بشكل أساسي الفاصلة المنقوطة. A \ g مع الجدل هو "طلقة واحدة"
بديل لل \o أمر.

\ gset [ بادئة ]
يرسل مخزن إدخال الاستعلام الحالي إلى الخادم ويخزن ناتج الاستعلام فيه
متغيرات psql (انظر المتغيرات). يجب أن يقوم الاستعلام المراد تنفيذه بإرجاع صف واحد بالضبط.
يتم تخزين كل عمود من الصف في متغير منفصل ، يسمى نفس المتغير
عمودي. على سبيل المثال:

=> اختر 'مرحبا' AS var1 ، 10 AS var2
-> \ gset
=> \صدى صوت : var1 : var2
مرحبا 10

إذا قمت بتحديد ملف بادئة، يتم إلحاق هذه السلسلة بأسماء أعمدة الاستعلام إلى
أنشئ أسماء المتغيرات المراد استخدامها:

=> اختر 'مرحبا' AS var1 ، 10 AS var2
-> \ gset نتيجة_
=> \صدى صوت : result_var1 : result_var2
مرحبا 10

إذا كانت نتيجة العمود فارغة ، فإن المتغير المقابل لا يتم تعيينه بدلاً من تعيينه.

إذا فشل الاستعلام أو لم يُرجع صفًا واحدًا ، فلن يتم تغيير أي متغيرات.

\ ح أو \ مساعدة [ أمر ]
يعطي تعليمات بناء الجملة لأمر SQL المحدد. لو أمر غير محدد ، ثم psql
سوف يسرد جميع الأوامر التي تتوفر لها تعليمات بناء الجملة. لو أمر هو
يتم عرض علامة النجمة (*) ، ثم تعليمات بناء الجملة على جميع أوامر SQL.

ملاحظات
لتبسيط الكتابة ، لا يجب أن تكون الأوامر التي تتكون من عدة كلمات
مقتبس. وبالتالي فمن الجيد أن تكتب \يساعد تغير جدول.

\ H أو \ html
يقوم بتشغيل تنسيق إخراج استعلام HTML. إذا كان تنسيق HTML قيد التشغيل بالفعل ، فسيتم تبديله
العودة إلى تنسيق النص الافتراضي المحاذاة. هذا الأمر للتوافق و
الراحة ، ولكن انظر \ pset حول تعيين خيارات الإخراج الأخرى.

\ i أو \ include اسم الملف
يقرأ المدخلات من الملف اسم الملف وينفذها كما لو كانت مطبوعة على
لوحة المفاتيح.

If اسم الملف هو - (واصلة) ، ثم تتم قراءة الإدخال القياسي حتى إشارة EOF أو \q
قيادة ميتا. يمكن استخدام هذا لتداخل المدخلات التفاعلية مع المدخلات من الملفات.
لاحظ أنه لن يتم استخدام سلوك Readline إلا إذا كان نشطًا في المستوى الخارجي.

ملاحظات
إذا كنت تريد رؤية السطور على الشاشة أثناء قراءتها ، فيجب عليك تعيين
متغير فحص إيكو للجميع.

\ ir أو \ include_relative اسم الملف
الأمر \ ir مشابه لـ \ i ، لكنه يحل أسماء الملفات النسبية بشكل مختلف. متي
التنفيذ في الوضع التفاعلي ، يتصرف الأمران بشكل متماثل. رغم ذلك، متى
تم استدعاؤه من برنامج نصي ، \ ir يفسر أسماء الملفات المتعلقة بالدليل الذي
يقع البرنامج النصي ، بدلاً من دليل العمل الحالي.

\ l [+] أو \ قائمة [+] [ النمط ]
قائمة قواعد البيانات في الخادم وإظهار أسماء وأصحاب ومجموعة الأحرف الخاصة بهم
الترميزات وامتيازات الوصول. لو النمط محدد ، فقط قواعد البيانات التي أسماؤها
تطابق النمط المدرجة. إذا تم إلحاق + باسم الأمر ، وأحجام قاعدة البيانات ،
يتم أيضًا عرض مساحات الجداول الافتراضية والأوصاف. (معلومات الحجم فقط
متاح لقواعد البيانات التي يمكن للمستخدم الحالي الاتصال بها.)

\ lo_export لاغ اسم الملف
يقرأ الكائن الكبير مع OID لاغ من قاعدة البيانات ويكتبها إلى اسم الملف. ملحوظة
أن هذا يختلف بمهارة عن وظيفة الخادم lo_exportالذي يعمل مع
أذونات المستخدم التي يتم تشغيل خادم قاعدة البيانات عليها وفي ملف الخادم
نظام.

نصيحه
استعمل \ lo_list لمعرفة معرف الكائن الكبير.

\ lo_import اسم الملف [ التعليق ]
يخزن الملف في كائن كبير PostgreSQL. اختياريا ، فإنه يربط المعطى
التعليق مع الكائن. مثال:

foo => \ lo_import "/home/peter/pictures/photo.xcf" 'a صورة of أنا'
Lo_import 152801

تشير الاستجابة إلى أن الكائن الكبير تلقى معرف الكائن 152801 ، والذي يمكن أن يكون
تستخدم للوصول إلى الكائن الكبير المنشأ حديثًا في المستقبل. من أجل خاطر
سهولة القراءة ، يوصى دائمًا بربط تعليق يمكن قراءته بواسطة الإنسان بكل
موضوع. يمكن عرض كل من معرفات الكائن والتعليقات باستخدام ملف \ lo_list أمر.

لاحظ أن هذا الأمر يختلف اختلافًا طفيفًا عن جانب الخادم lo_import لأنه
يعمل كمستخدم محلي في نظام الملفات المحلي ، بدلاً من مستخدم الخادم و
نظام الملفات.

\ lo_list
يعرض قائمة بجميع كائنات PostgreSQL الكبيرة المخزنة حاليًا في قاعدة البيانات ، جنبًا إلى جنب
مع أي تعليقات مقدمة لهم.

\ lo_unlink لاغ
يحذف الكائن الكبير مع OID لاغ من قاعدة البيانات.

نصيحه
استعمل \ lo_list لمعرفة معرف الكائن الكبير.

\ س أو \ خارج [ اسم الملف ]
\ س أو \ خارج [|أمر ]
يرتب لحفظ نتائج الاستعلام المستقبلية في الملف اسم الملف أو توجيه النتائج المستقبلية إلى
أمر شل أمر. إذا لم يتم تحديد وسيطة ، تتم إعادة تعيين إخراج الاستعلام إلى
الإخراج القياسي.

تتضمن "نتائج الاستعلام" جميع الجداول ، واستجابات الأوامر ، والإشعارات التي تم الحصول عليها من
خادم قاعدة البيانات ، بالإضافة إلى إخراج العديد من أوامر الشرطة المائلة العكسية التي تستعلم عن ملف
قاعدة بيانات (مثل \d) ، ولكن ليس رسائل الخطأ.

نصيحه
لإخراج النص بين نتائج الاستعلام ، استخدم \ qecho.

\ p أو \ طباعة
اطبع المخزن المؤقت للاستعلام الحالي إلى الإخراج القياسي.

\كلمه السر [ اسم المستخدم ]
يغير كلمة مرور المستخدم المحدد (افتراضيًا ، المستخدم الحالي). هذه
يطالب الأمر بكلمة المرور الجديدة ويقوم بتشفيرها وإرسالها إلى الخادم كملف
ALTER دور أمر. هذا يضمن أن كلمة المرور الجديدة لا تظهر بنص واضح
في محفوظات الأوامر أو سجل الخادم أو في أي مكان آخر.

\مستعجل [ نص ] الاسم
يحث المستخدم على توفير نص مخصص للمتغير الاسم. اختياري
سلسلة فورية ، نص، يمكن تحديدها. (للمطالبات متعددة الكلمات ، قم بإحاطة النص بـ
ونقلت واحدة.)

بشكل افتراضي ، يستخدم موجه الأوامر الطرفية للإدخال والإخراج. ومع ذلك ، إذا كان -f أمر
تم استخدام مفتاح الخط ، \ يستخدم موجه الإدخال القياسي والإخراج القياسي.

\ pset [ خيار [ قيمنا ]]
يقوم هذا الأمر بتعيين الخيارات التي تؤثر على مخرجات جداول نتائج الاستعلام. خيار
يشير إلى الخيار الذي سيتم تعيينه. دلالات قيمنا تختلف تبعا ل
الخيار المحدد. بالنسبة لبعض الخيارات ، الحذف قيمنا يتسبب في خيار التبديل أو
unset ، كما هو موضح تحت خيار معين. إذا لم يذكر مثل هذا السلوك ،
ثم الحذف قيمنا يؤدي فقط إلى عرض الإعداد الحالي.

\ pset بدون أي وسيطات يعرض الحالة الحالية لجميع خيارات الطباعة.

خيارات الطباعة القابلة للتعديل هي:

الحدود
ال قيمنا يجب أن يكون رقما. بشكل عام ، كلما زاد الرقم زادت الحدود و
ستحتوي الجداول على سطور ، لكن التفاصيل تعتمد على التنسيق المعين. في HTML
التنسيق ، سيتم ترجمة هذا مباشرة إلى الحدود = ... السمة. في معظم البلدان الأخرى
تنسيقات القيم فقط 0 (بلا حدود) و 1 (خطوط التقسيم الداخلية) و 2 (جدول
frame) منطقي ، وستتم معاملة القيم الموجودة أعلى 2 بنفس الطريقة التي يتم فيها التعامل مع الحدود = 2.
بالإضافة إلى ذلك ، تسمح تنسيقات latex و latex-longtable بقيمة 3 لإضافة قسمة
بين صفوف البيانات.

الأعمدة
يضبط العرض المستهدف للتنسيق المغلف ، وكذلك حد العرض لـ
تحديد ما إذا كان الإخراج واسعًا بما يكفي لطلب جهاز النداء أو التبديل إلى ملف
العرض الرأسي في الوضع التلقائي الموسع. الصفر (الافتراضي) يسبب العرض الهدف
ليتم التحكم فيها بواسطة متغير البيئة الأعمدة، أو عرض الشاشة المكتشفة
if الأعمدة لم يتم تعيين. بالإضافة إلى ذلك ، إذا كانت الأعمدة تساوي صفرًا ، فإن التنسيق المغلف
يؤثر فقط على إخراج الشاشة. إذا كانت الأعمدة غير صفرية ، فسيكون إخراج الملف والأنابيب
ملفوفة بهذا العرض أيضًا.

موسع (أو x)
If قيمنا تم تحديده يجب أن يكون إما قيد التشغيل أو إيقاف التشغيل ، مما سيمكّن أو يعطل
الوضع الموسع أو تلقائي. لو قيمنا تم حذف الأمر بالتبديل بين on و
من الإعدادات. عند تمكين الوضع الموسع ، يتم عرض نتائج الاستعلام في قسمين
أعمدة ، مع اسم العمود على اليسار والبيانات على اليمين. هذا الوضع
مفيد إذا كانت البيانات لا تناسب الشاشة في الوضع "الأفقي" العادي. في
الإعداد التلقائي ، يتم استخدام الوضع الموسع كلما كان ناتج الاستعلام أوسع
من الشاشة ، وإلا فسيتم استخدام الوضع العادي. الإعداد التلقائي هو فقط
فعالة في التنسيقات المحاذاة والمغلفة. في تنسيقات أخرى ، يتصرف دائمًا
كما لو تم إيقاف الوضع الموسع.

الحقول
يحدد فاصل المجال لاستخدامه في تنسيق الإخراج غير المحاذاة. بهذه الطريقة واحد
يمكن أن تخلق ، على سبيل المثال ، مخرجات مفصولة بعلامات جدولة أو فاصلة ، أي البرامج الأخرى
قد تفضل. لتعيين علامة تبويب كفاصل حقل ، اكتب \ pset fieldep '\ t'. ال
فاصل الحقل الافتراضي هو '|' (شريط عمودي).

الحقول
يضبط فاصل الحقل لاستخدامه في تنسيق الإخراج غير المحاذي إلى صفر بايت.

تذييل
If قيمنا تم تحديده ، يجب أن يكون إما قيد التشغيل أو إيقاف التشغيل والذي سيتم تمكينه أو تعطيله
عرض تذييل الجدول ((n عدد الصفوف). لو قيمنا تم حذف الأمر
تبديل عرض التذييل أو إيقاف تشغيله.

شكل
يضبط تنسيق الإخراج إلى تنسيق غير محاذي ومحاذاة وملفوفة و html و asciidoc و
اللاتكس (يستخدم جدولي) ، أو جدول طويل ، أو troff-ms. الاختصارات الفريدة هي
مسموح. (هذا يعني أن حرفًا واحدًا كافيًا).

يكتب التنسيق غير المحاذي جميع أعمدة الصف في سطر واحد ، مفصولاً بامتداد
فاصل المجال النشط حاليا. هذا مفيد لإنشاء الإخراج الذي قد يكون
المقصود أن تقرأها برامج أخرى (على سبيل المثال ، مفصولة بعلامات جدولة أو
تنسيق مفصولة بفواصل).

التنسيق المحاذي هو إخراج نص منسق بشكل جيد يمكن قراءته من قبل الإنسان ؛ هذه
هو الافتراضي.

التنسيق الملتف يشبه المحاذاة ولكنه يلتف قيم البيانات العريضة عبر الأسطر لعمل ملف
احتواء الإخراج في عرض العمود الهدف. يتم تحديد عرض الهدف كما هو موضح
تحت خيار الأعمدة. لاحظ أن psql لن يحاول التفاف رأس العمود
عناوين؛ لذلك ، يتصرف التنسيق الملتف بنفس طريقة المحاذاة إذا كان العرض الإجمالي
اللازمة لرؤوس الأعمدة يتجاوز الهدف.

تنسيقات html و asciidoc و latex و latex-longtable و troff-ms تضع الجداول
التي يُقصد تضمينها في المستندات باستخدام العلامات ذات الصلة
لغة. هم ليسوا وثائق كاملة! قد لا يكون هذا ضروريًا في HTML ،
ولكن في LaTeX ، يجب أن يكون لديك غلاف مستندات كامل. اللاتكس- longtable أيضا
يتطلب حزم LaTeX longtable و booktabs.

أسلوب الخط
يعيّن نمط رسم خط الحدود إلى واحد من ascii أو old-ascii أو unicode. فريد
يسمح بالاختصارات. (هذا يعني أن حرفًا واحدًا كافيًا). الافتراضي
الإعداد هو أسكي. يؤثر هذا الخيار فقط على تنسيقات الإخراج المحاذاة والمغلفة.

يستخدم أسلوب أسكي أحرف ASCII العادية. يتم عرض الأسطر الجديدة في البيانات باستخدام +
رمز في الهامش الأيمن. عندما يلتف تنسيق التفاف البيانات من سطر واحد
إلى التالي بدون حرف سطر جديد ، تظهر نقطة (.) في اليد اليمنى
هامش السطر الأول ومرة ​​أخرى في الهامش الأيسر للسطر التالي.

يستخدم نمط old-ascii أحرف ASCII العادية ، باستخدام نمط التنسيق المستخدم في
PostgreSQL 8.4 والإصدارات الأقدم. يتم عرض الأسطر الجديدة في البيانات باستخدام: رمز في المكان
من فاصل العمود الأيسر. عندما يتم التفاف البيانات من سطر واحد إلى ملف
التالي بدون حرف سطر جديد ، أ ؛ يستخدم الرمز بدلاً من اليد اليسرى
فاصل العمود.

يستخدم نمط unicode أحرف رسم مربع Unicode. يتم عرض الأسطر الجديدة في البيانات
باستخدام رمز إرجاع أول حرف في الهامش الأيمن. عندما يتم تغليف البيانات
من سطر إلى آخر بدون حرف سطر جديد ، يظهر رمز علامة القطع
في الهامش الأيمن من السطر الأول ومرة ​​أخرى في الهامش الأيسر لـ
السطر التالي.

عندما يكون إعداد الحد أكبر من الصفر ، فإن خيار النمط الخطي يحدد أيضًا
الأحرف التي يتم بها رسم خطوط الحدود. تعمل أحرف ASCII البسيطة
في كل مكان ، ولكن تبدو أحرف Unicode أجمل على شاشات العرض التي تتعرف عليها.

فارغة
يضبط السلسلة التي ستتم طباعتها بدلاً من القيمة الخالية. الافتراضي هو الطباعة
لا شيء ، والذي يمكن اعتباره خيطًا خيطًا بسهولة. على سبيل المثال ، ربما
تفضل \ pset خالية '(خالية)'.

رقمي
If قيمنا تم تحديده ، يجب أن يكون إما قيد التشغيل أو إيقاف التشغيل والذي سيتم تمكينه أو تعطيله
عرض حرف خاص بالإعدادات المحلية لفصل مجموعات الأرقام إلى يسار
العلامة العشرية. لو قيمنا تم حذف الأمر بالتبديل بين عادي و
الإخراج الرقمي الخاص بالإعدادات المحلية.

بيجر
يتحكم في استخدام برنامج بيجر للاستعلام وإخراج تعليمات psql. إذا كانت البيئة
متغير بيجر تم ضبطه ، يتم توجيه الإخراج إلى البرنامج المحدد. خلاف ذلك أ
يتم استخدام الوضع الافتراضي المعتمد على النظام الأساسي (مثل أكثر).

عند إيقاف تشغيل خيار بيجر ، لا يتم استخدام برنامج بيجر. عندما يكون خيار بيجر
قيد التشغيل ، يتم استخدام جهاز النداء عندما يكون ذلك مناسبًا ، أي عندما يكون الإخراج إلى محطة طرفية
ولن تناسب الشاشة. يمكن أيضًا تعيين خيار بيجر على دائمًا ، والذي
يتسبب في استخدام جهاز النداء لجميع المخرجات الطرفية بغض النظر عما إذا كان مناسبًا أم لا
على الشاشة. \ pset بيجر بدون ملف قيمنا تبديل استخدام جهاز النداء وإيقاف تشغيله.

pager_min_lines
إذا تم ضبط pager_min_lines على رقم أكبر من ارتفاع الصفحة ، فسيتم تعيين pager
لن يتم استدعاء البرنامج ما لم يكن هناك على الأقل العديد من خطوط الإخراج إلى
مشاهده. الإعداد الافتراضي هو 0.

السجلات
يحدد فاصل السجل (الخط) لاستخدامه في تنسيق الإخراج غير المحاذي. ال
الافتراضي هو حرف سطر جديد.

السجلات
يضبط فاصل السجل لاستخدامه في تنسيق الإخراج غير المحاذي على صفر بايت.

tableattr (أو T)
في تنسيق HTML ، يحدد هذا السمات التي يجب وضعها داخل علامة الجدول. هذه
يمكن أن تكون على سبيل المثال وسادة خلوية أو bgcolor. لاحظ أنك ربما لا تريد ذلك
حدد الحدود هنا ، حيث يتم الاهتمام بذلك بالفعل عن طريق \ pset border. إذا كان الجواب لا قيمنا
لم يتم تحديد سمات الجدول.

في تنسيق latex-longtable ، يتحكم هذا في العرض النسبي لكل عمود
تحتوي على نوع بيانات محاذاة إلى اليسار. يتم تحديده كمسافة مفصولة بمسافة بيضاء
قائمة القيم ، على سبيل المثال ، "0.2 0.2 0.6". أعمدة الإخراج غير المحددة تستخدم الأخير
القيمة المحددة.

الاسم
يعيّن عنوان الجدول لأي جداول مطبوعة لاحقًا. يمكن استخدام هذا في العطاء
العلامات الوصفية الناتجة الخاصة بك. إذا كان الجواب لا قيمنا لم يتم تحديد العنوان.

tuples_only (أو t)
If قيمنا تم تحديده ، يجب أن يكون إما قيد التشغيل أو إيقاف التشغيل والذي سيتم تمكينه أو تعطيله
وضع tuples-only. لو قيمنا تم حذف الأمر بالتبديل بين عادي و
خرج tuples فقط. يتضمن الإخراج العادي معلومات إضافية مثل العمود
الرؤوس والعناوين والتذييلات المختلفة. في وضع المجموعات فقط ، بيانات الجدول الفعلية فقط
معروض.

unicode_border_linestyle
يضبط نمط رسم الحدود لنمط خط unicode على نمط مفرد أو
مزدوج.

unicode_column_linestyle
يضبط نمط رسم العمود لنمط خط unicode على نمط مفرد أو نمط
مزدوج.

unicode_header_linestyle
يضبط نمط رسم الرأس لنمط خط unicode على نمط مفرد أو
مزدوج.

يمكن رؤية الرسوم التوضيحية لكيفية ظهور هذه التنسيقات المختلفة في قسم الأمثلة.

نصيحه
توجد أوامر مختصرة مختلفة لـ \ pset. شاهد \a, \C, \H, \t, \Tو \x.

\ q أو \ إنهاء
إنهاء برنامج psql. في ملف البرنامج النصي ، يتم إنهاء تنفيذ هذا البرنامج النصي فقط.

\ qecho نص [...]
هذا الأمر مماثل ل \صدى صوت فيما عدا أنه سيتم كتابة الإخراج إلى الاستعلام
قناة الإخراج ، على النحو الذي حدده \o.

\ r أو \ إعادة تعيين
يعيد (يمسح) مخزن الاستعلام المؤقت.

\س [ اسم الملف ]
طباعة محفوظات سطر أوامر psql إلى اسم الملف. إذا اسم الملف تم حذف التاريخ
مكتوبًا على الإخراج القياسي (باستخدام جهاز النداء إذا كان ذلك مناسبًا). هذا الأمر ليس كذلك
متاح إذا تم إنشاء psql بدون دعم Readline.

\يضع [ الاسم [ قيمنا [...]]]
يضبط متغير psql الاسم إلى قيمنا، أو إذا تم إعطاء أكثر من قيمة ، إلى
تسلسل كل منهم. إذا تم تقديم وسيطة واحدة فقط ، فسيتم تعيين المتغير بـ
قيمة فارغة. لإلغاء تعيين متغير ، استخدم \ unset أمر.

\يضع بدون أي وسيطات يعرض أسماء وقيم جميع psql المعينة حاليًا
المتغيرات.

يمكن أن تحتوي أسماء المتغيرات الصالحة على أحرف وأرقام وشرطات سفلية. انظر القسم
المتغيرات أدناه للحصول على التفاصيل. أسماء المتغيرات حساسة لحالة الأحرف.

على الرغم من أنك مرحب بك لتعيين أي متغير على أي شيء تريده ، إلا أن psql تتعامل مع العديد من المتغيرات
المتغيرات خاصة. تم توثيقها في قسم المتغيرات.

ملاحظات
هذا الأمر غير مرتبط بأمر SQL طقم(7).

\ setenv الاسم [ قيمنا ]
يضبط متغير البيئة الاسم إلى قيمنا، أو إذا كان قيمنا لم يتم توفيره ، غير محدد
متغير البيئة. مثال:

testdb => \ setenv بيجر أقل
testdb => \ setenv أقل -imx4F

\ sf [+] وصف_الوظيفة
يجلب هذا الأمر ويظهر تعريف الوظيفة المسماة ، في شكل ملف
خلق OR استبدال FUNCTION أمر. يتم طباعة التعريف على الاستعلام الحالي
قناة الإخراج ، على النحو الذي حدده \o.

يمكن تحديد الوظيفة الهدف بالاسم وحده ، أو بالاسم والوسيطات من أجل
مثال foo (عدد صحيح ، نص). يجب إعطاء أنواع الوسيطات إذا كان هناك أكثر من واحد
وظيفة بنفس الاسم.

إذا تم إلحاق + باسم الأمر ، فسيتم ترقيم سطور الإخراج بامتداد
السطر الأول من جسم الوظيفة هو السطر 1.

\t
يبدل عرض عناوين اسم عمود الإخراج وتذييل عدد الصفوف. هذا الأمر
يعادل \ pset tuples_only ويتم توفيره للراحة.

\T خيارات الجدول
يحدد السمات التي سيتم وضعها داخل علامة الجدول بتنسيق إخراج HTML. هذه
الأمر يعادل \ pset tableattr خيارات الجدول.

\ توقيت [ on | خصم ]
بدون معلمة ، يبدل عرض المدة التي تستغرقها كل جملة SQL ، بتنسيق
مللي ثانية. مع المعلمة ، يحدد نفسه.

\ unset الاسم
يضبط (يحذف) متغير psql الاسم.

\ w أو \ الكتابة اسم الملف
\ w أو \ كتابة |أمر
إخراج مخزن الاستعلام الحالي إلى الملف اسم الملف أو توجيهها إلى أمر shell
أمر.

\راقب [ ثواني ]
تكرار تنفيذ المخزن المؤقت للاستعلام الحالي (مثل \ g) حتى تتم مقاطعته أو الاستعلام
فشل. انتظر عدد الثواني المحدد (الافتراضي 2) بين عمليات التنفيذ.

\ x [ on | خصم | السيارات ]
لتعيين وضع تنسيق الجدول الموسع أو تبديله. على هذا النحو فإنه يعادل \ pset
موسع.

\ ض [ النمط ]
يسرد الجداول وطرق العرض والتسلسلات مع امتيازات الوصول المرتبطة بها. اذا كان
النمط فقط الجداول وطرق العرض والتسلسلات التي تتطابق أسماؤها مع النمط
مدرجة.

هذا هو الاسم المستعار ل \ موانئ دبي ("امتيازات العرض").

\! [ أمر ]
يهرب إلى غلاف منفصل أو ينفذ أمر shell أمر. الحجج
لا مزيد من التأويل ؛ ستراهم الصدفة كما هي. على وجه الخصوص ، المتغير
لا تنطبق قواعد الاستبدال وعمليات الهروب بالخط المائل العكسي.

\؟ [ موضوع ]
يظهر معلومات المساعدة. اختياري موضوع المعلمة (الافتراضية للأوامر) تحدد
أي جزء من psql موضح: الأوامر تصف أوامر psql's backslash ؛ والخيارات
يصف خيارات سطر الأوامر التي يمكن تمريرها إلى psql ؛ والمتغيرات يظهر
مساعدة حول متغيرات التكوين psql.

أنماط
الأوامر المختلفة \ d تقبل ملف النمط معلمة لتحديد اسم (أسماء) الكائن المطلوب
عرض. في أبسط الحالات ، يكون النمط هو مجرد الاسم الدقيق للكائن. ال
عادةً ما يتم طي الأحرف داخل النمط إلى أحرف صغيرة ، تمامًا كما هو الحال في أسماء SQL ؛
على سبيل المثال ، \ dt FOO سيعرض الجدول المسمى foo. كما هو الحال في أسماء SQL ، يتم وضع double
علامات الاقتباس حول النموذج تتوقف عن طيها إلى حالة الأحرف الصغيرة. هل يجب عليك تضمين ملف
حرف اقتباس مزدوج حقيقي في نمط ، اكتبه كزوج من علامات الاقتباس المزدوجة في الداخل
تسلسل اقتباس مزدوج مرة أخرى هذا يتوافق مع قواعد SQL المقتبسة
معرفات. على سبيل المثال ، \ dt "FOO" "BAR" سيعرض الجدول المسمى FOO "BAR (ليس
foo "bar). على عكس القواعد العادية لأسماء SQL ، يمكنك وضع علامات اقتباس مزدوجة حولها
جزء من النمط ، على سبيل المثال \ dt FOO "FOO" BAR سيعرض الجدول المسمى
fooFOObar.

كلما النمط تم حذف المعلمة بالكامل ، تعرض أوامر \ d الكل
الكائنات المرئية في مسار بحث المخطط الحالي - وهذا يعادل
باستخدام * كنمط. (يُقال أن الكائن يكون مرئيًا إذا كان المخطط الذي يحتوي عليه
في مسار البحث ولا يظهر أي كائن من نفس النوع والاسم سابقًا في
مسار البحث. هذا يعادل البيان الذي يمكن الإشارة إليه من قبل الكائن
الاسم بدون تأهيل مخطط صريح.) لمشاهدة كافة الكائنات في قاعدة البيانات
بغض النظر عن الرؤية ، استخدم *. * كنمط.

داخل النمط ، * تطابق أي تسلسل من الأحرف (بما في ذلك عدم وجود أحرف) و؟
يطابق أي حرف واحد. (هذا الترميز يمكن مقارنته باسم ملف shell الخاص بـ Unix
أنماط.) على سبيل المثال ، يعرض \ dt int * الجداول التي تبدأ أسماؤها بـ int. لكن
داخل علامتي اقتباس مزدوجتين ، * و؟ تفقد هذه المعاني الخاصة وتتطابق فقط
حرفيا.

يتم تفسير النمط الذي يحتوي على نقطة (.) على أنه نمط اسم مخطط متبوعًا به
نمط اسم الكائن. على سبيل المثال ، يعرض \ dt foo *. * bar * جميع الجداول التي يكون جدولها
يتضمن الاسم شريطًا في المخططات التي يبدأ اسم مخططها بـ foo. عندما لا توجد نقطة
يظهر ، ثم يتطابق النمط مع الكائنات المرئية في المخطط الحالي فقط
مسار البحث. مرة أخرى ، النقطة الموجودة داخل علامتي الاقتباس المزدوجة تفقد معناها الخاص وهي كذلك
يقابل حرفيا.

يمكن للمستخدمين المتقدمين استخدام تدوينات التعبيرات العادية مثل فئات الأحرف ، لـ
مثال [0-9] لمطابقة أي رقم. تعمل جميع الأحرف الخاصة للتعبير العادي كـ
المحدد في القسم 9.7.3 ، "تعبيرات POSIX العادية" ، في الوثائق ، باستثناء
ل . التي يتم أخذها كفاصل كما هو مذكور أعلاه ، * والذي تمت ترجمته إلى
تدوين التعبير العادي. *،؟ الذي تمت ترجمته إلى. و $ الذي يتم مطابقة
حرفيا. يمكنك محاكاة هذه الأحرف عند الحاجة عن طريق الكتابة؟ ل .، (R+ |)
لـ R*، أو (R|) من أجل R؟. $ ليس مطلوبًا كحرف تعبير عادي منذ
يجب أن يتطابق النمط مع الاسم بالكامل ، على عكس التفسير المعتاد للنمط العادي
التعبيرات (بمعنى آخر ، يتم إلحاق $ تلقائيًا بالنمط الخاص بك). اكتب * في
البداية و / أو النهاية إذا كنت لا ترغب في تثبيت النمط. لاحظ أن
ضمن علامتي اقتباس مزدوجتين ، تفقد جميع الأحرف الخاصة للتعبير العادي خصائصها الخاصة
المعاني والمطابقة حرفيا. أيضا ، أحرف خاصة للتعبير النمطي
تتم مطابقة حرفيا في أنماط اسم المشغل (على سبيل المثال ، وسيطة \ do).

متقدم شرح المميزات:
المتغيرات
يوفر psql ميزات استبدال متغيرة مشابهة لقذائف أوامر Unix الشائعة.
المتغيرات هي ببساطة أزواج اسم / قيمة ، حيث يمكن أن تكون القيمة أي سلسلة من أي منها
الطول. يجب أن يتكون الاسم من أحرف (بما في ذلك الأحرف غير اللاتينية) وأرقام و
شرطة سفلية.

لتعيين متغير ، استخدم الأمر psql meta \يضع. على سبيل المثال،

testdb => \يضع فو شريط

يضبط المتغير foo على شريط القيمة. لاسترداد محتوى المتغير ،
تسبق الاسم بنقطتين ، على سبيل المثال:

testdb => \صدى صوت : foo
شريط

يعمل هذا في كل من أوامر SQL العادية والأوامر الوصفية ؛ هناك المزيد من التفاصيل في SQL
الاستيفاء أدناه.

إذا اتصلت \يضع بدون وسيطة ثانية ، يتم تعيين المتغير بسلسلة فارغة
كقيمة. لإلغاء تعيين (أي حذف) متغير ، استخدم الأمر \ unset. لإظهار ملف
قيم جميع المتغيرات ، استدعاء \يضع بدون أي جدال.

ملاحظات
حجج \يضع تخضع لنفس قواعد الاستبدال كما هو الحال مع الآخرين
أوامر. وبالتالي يمكنك إنشاء مراجع مثيرة للاهتمام مثل \ set: foo
"شيء ما" والحصول على "روابط لينة" أو "متغيرات متغيرة" من شهرة Perl أو PHP ،
على التوالى. لسوء الحظ (أو لحسن الحظ؟) ، لا توجد طريقة لفعل أي شيء
مفيدة مع هذه التركيبات. من ناحية أخرى ، \ set bar: foo ممتاز
طريقة صالحة لنسخ متغير.

يتم التعامل مع عدد من هذه المتغيرات بشكل خاص بواسطة psql. إنهم يمثلون أكيد
إعدادات الخيار التي يمكن تغييرها في وقت التشغيل عن طريق تغيير قيمة المتغير ،
أو في بعض الحالات تمثل حالة متغيرة من psql. على الرغم من أنه يمكنك استخدام هذه
المتغيرات لأغراض أخرى ، لا ينصح بذلك ، كما قد يكون سلوك البرنامج
تنمو بشكل غريب حقًا بسرعة حقًا. حسب الاصطلاح ، جميع المتغيرات المعالجة بشكل خاص '
تتكون الأسماء من جميع أحرف ASCII الكبيرة (وربما الأرقام والشرطات السفلية).
لضمان أقصى قدر من التوافق في المستقبل ، تجنب استخدام أسماء المتغيرات هذه لـ
أغراضك الخاصة. فيما يلي قائمة بجميع المتغيرات المعالجة بشكل خاص.

السيارات
عند التشغيل (الافتراضي) ، يتم تنفيذ كل أمر SQL تلقائيًا عند النجاح
انتهاء. لتأجيل الالتزام في هذا الوضع ، يجب عليك إدخال ملف ابدأ or إبدأ
عملية تجارية أمر SQL. عند الإيقاف أو عدم الضبط ، لا يتم الالتزام بأوامر SQL حتى
قمت بإصداره صراحة ارتكب or END. يعمل وضع الإيقاف التلقائي عن طريق إصدار ملف
ضمني ابدأ بالنسبة لك ، قبل أي أمر غير موجود بالفعل في ملف
كتلة الصفقة وليس في حد ذاته أ ابدأ أو أمر آخر للتحكم في المعاملات ،
ولا أمر لا يمكن تنفيذه داخل كتلة معاملة (مثل مكنسة).

ملاحظات
في وضع الإيقاف التلقائي ، يجب أن تتخلى صراحةً عن أي معاملة فاشلة بحلول
الدخول إحباط or رول باك. ضع في اعتبارك أيضًا أنك إذا خرجت من الجلسة
دون أن تلتزم ، سيضيع عملك.

ملاحظات
يعد وضع الالتزام التلقائي هو السلوك التقليدي لـ PostgreSQL ، ولكن
الالتزام التلقائي هو أقرب إلى مواصفات SQL. إذا كنت تفضل الالتزام التلقائي ، فأنت
قد ترغب في تعيينه في ملف psqlrc على مستوى النظام أو ملف ~ / .psqlrc ملف.

COMP_KEYWORD_CASE
يحدد حالة الأحرف التي سيتم استخدامها عند إكمال كلمة مفتاح SQL. إذا تم التعيين على
السفلي أو العلوي ، ستكون الكلمة المكتملة بأحرف صغيرة أو كبيرة ، على التوالي.
إذا تم ضبطه على حفظ - سفلي أو احتفاظ - علوي (الافتراضي) ، فإن الكلمة المكتملة ستفعل
يكون في حالة الكلمة التي تم إدخالها بالفعل ، ولكن الكلمات مكتملة بدونها
أي شيء يتم إدخاله سيكون بأحرف صغيرة أو كبيرة ، على التوالي.

DBNAME
اسم قاعدة البيانات التي تتصل بها حاليًا. يتم تعيين هذا في كل مرة
تقوم بالاتصال بقاعدة بيانات (بما في ذلك بدء تشغيل البرنامج) ، ولكن يمكن عدم ضبطها.

فحص إيكو
في حالة التعيين على الكل ، ستتم طباعة كافة سطور الإدخال غير الفارغة على الإخراج القياسي كما هي
اقرأ. (لا ينطبق هذا على الأسطر التي تُقرأ بشكل تفاعلي.) لتحديد هذا السلوك
عند بدء تشغيل البرنامج ، استخدم المفتاح -a. في حالة التعيين على الاستعلامات ، يقوم psql بطباعة كل استعلام
إلى الإخراج القياسي حيث يتم إرساله إلى الخادم. التبديل لهذا هو -e. إذا تم ضبطه
إلى الأخطاء ، يتم عرض الاستعلامات الفاشلة فقط عند إخراج الخطأ القياسي. ال
التبديل لهذا هو -b. إذا لم يتم ضبطها ، أو إذا تم ضبطها على لا شيء (أو أي قيمة أخرى غير تلك
أعلاه) ثم لا يتم عرض أي استفسارات.

صدى
عندما يتم تعيين هذا المتغير إلى on ويقوم أمر الخط المائل العكسي بالاستعلام عن قاعدة البيانات ، فإن ملف
يتم عرض الاستعلام لأول مرة. تساعدك هذه الميزة على دراسة العناصر الداخلية لـ PostgreSQL و
توفر وظائف مماثلة في برامجك الخاصة. (لتحديد هذا السلوك على
بدء تشغيل البرنامج ، استخدم المفتاح -E.) إذا قمت بتعيين المتغير على القيمة noexec ،
يتم عرض الاستعلامات فقط ولكن لا يتم إرسالها فعليًا إلى الخادم وتنفيذها.

التشفير
ترميز مجموعة أحرف العميل الحالي.

FETCH_COUNT
إذا تم تعيين هذا المتغير على قيمة عدد صحيح> 0 ، فإن نتائج اختر الاستفسارات
تم جلبها وعرضها في مجموعات من تلك الصفوف العديدة ، بدلاً من الافتراضي
سلوك جمع مجموعة النتائج بالكامل قبل عرضها. لذلك فقط أ
يتم استخدام كمية محدودة من الذاكرة ، بغض النظر عن حجم مجموعة النتائج.
يتم استخدام الإعدادات من 100 إلى 1000 بشكل شائع عند تمكين هذه الميزة. تذكر
أنه عند استخدام هذه الميزة ، قد يفشل الاستعلام بعد عرضه بالفعل
بعض الصفوف.

نصيحه
على الرغم من أنه يمكنك استخدام أي تنسيق إخراج مع هذه الميزة ، إلا أن المحاذاة الافتراضية
يميل التنسيق إلى الظهور بشكل سيئ لأن كل مجموعة من FETCH_COUNT ستكون الصفوف
منسق بشكل منفصل ، مما يؤدي إلى اختلاف عرض العمود عبر مجموعات الصفوف.
تعمل تنسيقات الإخراج الأخرى بشكل أفضل.

نظام HISTCONTROL
إذا تم تعيين هذا المتغير على مسافة جهل ، فإن الأسطر التي تبدأ بمسافة ليست كذلك
دخلت في قائمة التاريخ. إذا تم التعيين على قيمة عمليات التجاهل ، فإن الأسطر المطابقة لملف
لم يتم إدخال سطر التاريخ السابق. تجمع قيمة ignoreboth بين الاثنين
والخيارات. في حالة عدم التعيين أو التعيين على لا شيء (أو أي قيمة أخرى غير تلك المذكورة أعلاه) ، الكل
يتم حفظ الأسطر التي تمت قراءتها في الوضع التفاعلي في قائمة المحفوظات.

ملاحظات
هذه الميزة كانت مسروقة بلا خجل من باش.

الملف الشخصي
اسم الملف الذي سيتم استخدامه لتخزين قائمة المحفوظات. النظام الأساسي
~ / .psql_history. على سبيل المثال ، وضع:

\ مجموعة HISTFILE ~ / .psql_history- : DBNAME

in ~ / .psqlrc سيؤدي إلى احتفاظ psql بتاريخ منفصل لكل قاعدة بيانات.

ملاحظات
هذه الميزة كانت مسروقة بلا خجل من باش.

ارتفاع
عدد الأوامر المراد تخزينها في محفوظات الأوامر. القيمة الافتراضية هي 500.

ملاحظات
هذه الميزة كانت مسروقة بلا خجل من باش.

HOST
مضيف خادم قاعدة البيانات الذي تتصل به حاليًا. يتم تعيين هذا في كل مرة
تقوم بالاتصال بقاعدة بيانات (بما في ذلك بدء تشغيل البرنامج) ، ولكن يمكن عدم ضبطها.

إجنوريوف
في حالة عدم الضبط ، يتم إرسال حرف EOF (عادةً Control + D) إلى جلسة تفاعلية
من psql سينهي التطبيق. إذا تم تعيينه على قيمة عددية ، فإن هذا العدد الكبير من EOF
يتم تجاهل الأحرف قبل إنهاء التطبيق. إذا تم تعيين المتغير
لكن ليس لها قيمة عددية ، القيمة الافتراضية هي 10.

ملاحظات
هذه الميزة كانت مسروقة بلا خجل من باش.

لاستويد
قيمة آخر معرف الكائن المتأثر ، كما تم إرجاعه من ملف INSERT or \ lo_import
أمر. هذا المتغير مضمون فقط ليكون صالحًا حتى بعد نتيجة
تم عرض أمر SQL التالي.

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

ON_ERROR_STOP
بشكل افتراضي ، تستمر معالجة الأمر بعد حدوث خطأ. عندما يتم تعيين هذا المتغير
في ، ستتوقف المعالجة على الفور بدلاً من ذلك. في الوضع التفاعلي ، سوف psql
العودة إلى موجه الأوامر ؛ خلاف ذلك ، سيتم الخروج psql ، وإرجاع رمز الخطأ 3 إلى
تمييز هذه الحالة عن حالات الخطأ الفادح ، التي يتم الإبلاغ عنها باستخدام الخطأ
الكود 1. في كلتا الحالتين ، فإن أي نصوص برمجية قيد التشغيل حاليًا (نص المستوى الأعلى ، إذا
أي ، وأي نصوص أخرى قد تكون قد تم استدعاؤها في) سيتم إنهاؤها
فورا. إذا احتوت سلسلة أوامر المستوى الأعلى على أوامر SQL متعددة ،
ستتوقف المعالجة مع الأمر الحالي.

PORT
منفذ خادم قاعدة البيانات الذي تتصل به حاليًا. تم تعيين هذا كل
الوقت الذي تتصل فيه بقاعدة بيانات (بما في ذلك بدء تشغيل البرنامج) ، ولكن يمكن عدم ضبطه.

موجه1
موجه2
موجه3
هذه تحدد ما يجب أن تبدو عليه مشكلات psql. انظر المطالبة أدناه.

هادئ
ضبط هذا المتغير على تشغيل يكافئ خيار سطر الأوامر -q. فمن
ربما لا يكون مفيدًا جدًا في الوضع التفاعلي.

سطر واحد
ضبط هذا المتغير على تشغيل يكافئ خيار سطر الأوامر -S.

خطوة واحدة
ضبط هذا المتغير على تشغيل يكافئ خيار سطر الأوامر -s.

USER
مستخدم قاعدة البيانات الذي تتصل به حاليًا بصفته. يتم تعيين هذا في كل مرة تقوم فيها
الاتصال بقاعدة بيانات (بما في ذلك بدء تشغيل البرنامج) ، ولكن يمكن عدم ضبطها.

ضراوة
يمكن تعيين هذا المتغير على القيم الافتراضية أو المطول أو المقتضب للتحكم في
الإسهاب في تقارير الخطأ.

SQL استيفاء
الميزة الرئيسية لمتغيرات psql هي أنه يمكنك استبدالها ("إقحام") بها
عبارات SQL العادية ، بالإضافة إلى وسيطات الأوامر الوصفية. علاوة على ذلك ، psql
يوفر تسهيلات لضمان استخدام القيم المتغيرة كملفات SQL الحرفية و
المعرفات مقتبسة بشكل صحيح. بناء الجملة لاستيفاء قيمة بدون أي
الاقتباس هو إرفاق اسم المتغير بنقطتين (:). على سبيل المثال،

testdb => \يضع فو 'طاولتي'
testdb => اختر * من عند : foo؛

سوف الاستعلام عن الجدول my_table. لاحظ أن هذا قد يكون غير آمن: قيمة ملف
المتغير يتم نسخه حرفيًا ، لذلك يمكن أن يحتوي على علامات اقتباس غير متوازنة ، أو حتى شرطة مائلة للخلف
أوامر. يجب أن تتأكد من أنه منطقي في المكان الذي تضعه فيه.

عندما يتم استخدام قيمة كمعرف SQL حرفي أو معرف ، يكون الترتيب الأكثر أمانًا
ليتم اقتباسها. لاقتباس قيمة متغير على هيئة حرفية SQL ، اكتب نقطتين
متبوعًا باسم المتغير في علامات الاقتباس الفردية. لاقتباس القيمة كملف SQL
المعرف ، اكتب نقطتين متبوعًا باسم المتغير بين علامتي اقتباس مزدوجتين. هؤلاء
تتعامل التركيبات بشكل صحيح مع علامات الاقتباس والأحرف الخاصة الأخرى المضمنة في
قيمة متغيرة. يمكن كتابة المثال السابق بشكل أكثر أمانًا بهذه الطريقة:

testdb => \يضع فو 'طاولتي'
testdb => اختر * من عند : "فو" ؛

لن يتم إجراء الاستيفاء المتغير في حرفية SQL المقتبسة و
معرفات. لذلك ، لا يعمل إنشاء مثل ": foo" لإنتاج علامات اقتباس
حرفية من قيمة المتغير (وسيكون غير آمن إذا نجح ، لأنه
لن يتعامل بشكل صحيح مع علامات الاقتباس المضمنة في القيمة).

أحد الأمثلة على استخدام هذه الآلية هو نسخ محتويات ملف إلى جدول
عمودي. قم أولاً بتحميل الملف في متغير ثم اقحم قيمة المتغير
كسلسلة مقتبسة:

testdb => \يضع محتوى "القط my_file.txt`
testdb => INSERT INTO طاولتي القيم (:'المحتوى')؛

(لاحظ أن هذا لا يزال لا يعمل إذا كان my_file.txt يحتوي على NUL بايت. psql لا
دعم وحدات بايت NUL المضمنة في قيم متغيرة.)

نظرًا لأن النقطتين يمكن أن تظهر بشكل قانوني في أوامر SQL ، فهي محاولة واضحة في الاستيفاء
(أي: الاسم ، أو: "الاسم" ، أو: "الاسم") لا يتم استبداله إلا إذا كان المتغير المسمى
مجموعة حاليا. على أي حال ، يمكنك الهروب من القولون بشرطة مائلة للخلف لحمايته منه
الاستبدال.

صيغة النقطتين للمتغيرات هي لغة SQL قياسية للغات الاستعلام المضمنة ، مثل
ECPG. تراكيب القولون لشرائح المصفوفة وطبقات النوع هي امتدادات PostgreSQL ،
والتي يمكن أن تتعارض أحيانًا مع الاستخدام القياسي. صيغة القولون والاقتباس لـ
الهروب من قيمة المتغير كمعرف SQL حرفي هو امتداد psql.

مطالبة
يمكن تخصيص مطالبات psql حسب تفضيلاتك. المتغيرات الثلاثة
موجه1, موجه2و موجه3 تحتوي على سلاسل وتسلسلات هروب خاصة
صف مظهر الموجه. الموجه 1 هو الموجه العادي الذي يتم إصداره
عندما يطلب psql أمرًا جديدًا. يتم إصدار الموجه 2 عند توقع المزيد من المدخلات
أثناء إدخال الأمر لأنه لم يتم إنهاء الأمر بفاصلة منقوطة أو a
لم يتم إغلاق الاقتباس. يتم إصدار الموجه 3 عند تشغيل SQL COPY الأمر وأنت
من المتوقع أن تكتب قيم الصف على الجهاز.

تتم طباعة قيمة متغير المطالبة المحدد حرفيًا ، باستثناء النسبة المئوية
تمت مصادفة علامة (٪). اعتمادًا على الحرف التالي ، هناك نص آخر معين
استبدال بدلا من ذلك. البدائل المحددة هي:

%M
اسم المضيف الكامل (مع اسم المجال) لخادم قاعدة البيانات ، أو [محلي] إذا كان
الاتصال عبر مقبس مجال Unix ، أو [محلي:/ دير / الاسم] ، إذا كان مجال Unix
المقبس ليس في المترجمة في الموقع الافتراضي.

%m
اسم مضيف خادم قاعدة البيانات ، مبتوراً عند النقطة الأولى ، أو [محلي] إذا
الاتصال عبر مقبس مجال يونكس.

%>
رقم المنفذ الذي يستمع إليه خادم قاعدة البيانات.

%n
اسم مستخدم جلسة قاعدة البيانات. (قد يتغير توسيع هذه القيمة أثناء أ
جلسة قاعدة البيانات كنتيجة للأمر طقم جلسة التخويل.)

%/
اسم قاعدة البيانات الحالية.

%~
مثل٪ / ، لكن الناتج هو ~ (علامة التلدة) إذا كانت قاعدة البيانات هي قاعدة البيانات الافتراضية.

%#
إذا كان مستخدم الجلسة هو مستخدم متميز لقاعدة البيانات ، فعندئذٍ # ، وإلا a>. (ال
قد يتغير توسيع هذه القيمة أثناء جلسة قاعدة البيانات كنتيجة لـ
الامر طقم جلسة التخويل.)

%R
في الموجه 1 عادةً = ، ولكن ^ إذا كان في وضع سطر واحد ، و! إذا كانت الجلسة
غير متصل بقاعدة البيانات (وهو ما يمكن أن يحدث إذا \الاتصال فشل). في موجه 2
يتم استبدال التسلسل بـ - أو * أو عرض أسعار واحد أو عرض أسعار مزدوج أو دولار
تسجيل ، اعتمادًا على ما إذا كان psql يتوقع المزيد من المدخلات لأن الأمر لم يكن كذلك
تم إنهاؤه بعد ، لأنك داخل / * ... * / تعليق ، أو لأنك كذلك
داخل سلسلة مقتبسة أو خالية من الدولار. في الموجه 3 لا ينتج التسلسل
اى شى.

%x
حالة المعاملة: سلسلة فارغة عندما لا تكون في كتلة معاملة ، أو * عندما تكون في
كتلة صفقة ، أو! عندما تكون في كتلة معاملة فاشلة ، أو؟ عندما
حالة المعاملة غير محددة (على سبيل المثال ، لعدم وجود اتصال).

%l
رقم السطر داخل البيان الحالي ، بدءًا من 1.

%الأرقام
يتم استبدال الحرف ذو الرمز الثماني المشار إليه.

%:الاسم:
قيمة المتغير psql الاسم. راجع قسم المتغيرات للحصول على التفاصيل.

%`أمر`
إخراج أمر، على غرار الاستبدال العادي "الخلفي".

٪ [...٪]
يمكن أن تحتوي الموجهات على أحرف تحكم المحطة الطرفية والتي ، على سبيل المثال ، تغير
لون نص المطالبة أو خلفيته أو نمطه ، أو قم بتغيير عنوان ملف
نافذة المحطة. لكي تعمل ميزات تحرير الخط في Readline
بشكل صحيح ، يجب تحديد أحرف التحكم غير المطبوعة على أنها غير مرئية بواسطة
حولهم مع٪ [و٪]. يمكن أن تحدث أزواج متعددة من هذه داخل
مستعجل. على سبيل المثال:

testdb => \ set PROMPT1 '٪ [٪ 033 [1؛ 33؛ 40m٪]٪ n @٪ /٪ R٪ [٪ 033 [0m٪]٪ #'

ينتج عنه موجه غامق (1 ؛) أصفر على أسود (33 ؛ 40) على متوافق مع VT100 ،
محطات قادرة على اللون.
لإدراج علامة النسبة المئوية في موجهك ، اكتب ٪٪. المطالبات الافتراضية هي "٪ /٪ R٪ #"
للمطالبات 1 و 2 ، و ">>" للمطالبة 3.

ملاحظات
تم سرقة هذه الميزة بلا خجل من tcsh.

سطر الأوامر تحرير
يدعم psql مكتبة Readline من أجل تحرير الخط واسترجاعه بسهولة. ال
يتم حفظ محفوظات الأوامر تلقائيًا عند خروج psql وإعادة تحميلها عند psql
يبدأ العمل. يتم أيضًا دعم إكمال الجدولة ، على الرغم من أن منطق الإكمال لا يجعل
يدعي أنه محلل SQL. يمكن أن تتداخل الاستعلامات التي تم إنشاؤها بواسطة إكمال علامة التبويب أيضًا
مع أوامر SQL الأخرى ، على سبيل المثال تحديد مستوى عزل المعاملة. إذا كنت لسبب ما
لا تحب إكمال علامة التبويب ، يمكنك إيقاف تشغيلها بوضع هذا في ملف باسم
.inputrc في دليل منزلك:

$ إذا بسكل
تعيين تعطيل الإكمال على
$ endif

(هذه ليست psql ولكنها ميزة Readline. اقرأ وثائقها لمزيد من المعلومات
تفاصيل.)

البيئة

الأعمدة
إذا كانت \ pset أعمدة تساوي صفرًا ، فإنه يتحكم في عرض التنسيق والعرض الخاصين بالالتفاف لـ
تحديد ما إذا كان الإخراج العريض يتطلب جهاز النداء أو يجب تحويله إلى الوضع الرأسي
التنسيق في الوضع التلقائي الموسع.

بيجر
إذا كانت نتائج الاستعلام لا تتناسب مع الشاشة ، فسيتم تمريرها من خلال هذا الأمر.
القيم النموذجية أكثر أو أقل. الافتراضي يعتمد على النظام الأساسي. استخدام
يمكن تعطيل جهاز النداء باستخدام ملف \ pset أمر.

قاعدة بيانات PG
شبح
بي جي بورت
PGUSER
معلمات الاتصال الافتراضية (انظر القسم 31.14 ، "متغيرات البيئة" ، في
توثيق).

PSQL_EDITOR
EDITOR
VISUAL
المحرر المستخدم من قبل \e و \ ef أوامر. يتم فحص المتغيرات بالترتيب
المدرجة ؛ يتم استخدام أول مجموعة.

برامج التحرير الافتراضية المضمنة هي vi على أنظمة Unix و notepad.exe على Windows
الأنظمة.

PSQL_EDITOR_LINENUMBER_ARG
متى \e or \ ef يستخدم مع وسيطة رقم سطر ، وهذا المتغير يحدد
يتم استخدام وسيطة سطر الأوامر لتمرير رقم سطر البداية إلى محرر المستخدم. ل
المحررين مثل Emacs أو vi ، هذه علامة زائد. قم بتضمين مسافة زائدة في ملف
قيمة المتغير إذا لزم وجود مسافة بين اسم الخيار والخط
عدد. أمثلة:

PSQL_EDITOR_LINENUMBER_ARG = '+'
PSQL_EDITOR_LINENUMBER_ARG = '- سطر'

الافتراضي هو + في أنظمة Unix (المقابلة للمحرر الافتراضي vi ، وهو مفيد
للعديد من المحررين المشتركين الآخرين) ؛ ولكن لا يوجد تقصير على أنظمة Windows.

PSQL_HISTORY
موقع بديل لملف محفوظات الأوامر. يتم تنفيذ التوسع تيلدا (~).

PSQLRC
موقع بديل لملف .psqlrc الخاص بالمستخدم. يتم تنفيذ التوسع تيلدا (~).

SHELL
الأمر الذي ينفذه \! أمر.

تمبير
دليل لتخزين الملفات المؤقتة. الافتراضي هو / tmp.

هذه الأداة ، مثل معظم أدوات PostgreSQL الأخرى ، تستخدم أيضًا متغيرات البيئة
بدعم من libpq (راجع القسم 31.14 ، "متغيرات البيئة" ، في الوثائق).

استخدم psql عبر الإنترنت باستخدام خدمات onworks.net