diff --git a/ar/basic/admin-panel/computed-outbox.mdx b/ar/basic/admin-panel/computed-outbox.mdx index 34ce45eb..35053f8a 100644 --- a/ar/basic/admin-panel/computed-outbox.mdx +++ b/ar/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ description: "راقب تسليم BullMQ وتراكم المهام المحسو | القسم | السؤال الذي يجيب عنه | | --- | --- | | الملخص | زمن الاستجابة من البداية إلى النهاية، ووقت تغير المصدر، ووقت استقرار القيمة، والجدول والحقول التي شغّلت التنفيذ. تعني شارة **قيد الحوسبة** أن السلسلة لا تزال قيد التشغيل. | -| **المخطط الزمني** | وقت إدراج التشغيل في قائمة الانتظار وبدئه واكتماله أو فشله. | -| **سلسلة المهام** | كل مهمة في التسلسل، متداخلة تحت المهمة التي أدرجتها في قائمة الانتظار، حتى تتمكن من معرفة مصدر كل فرع. يعرض كل صف حالته وخطوات الخطة و**هدف الكتابة** (الجدول والحقول التي تحدّثها المهمة) و**الصفوف المتسخة** وعمق التسلسل ووقت الإدراج والمدة. | +| **المخطط الزمني** | ثلاثة مسارات متجاورة: **من الطرف إلى الطرف** يمتد من تغيّر المصدر حتى استقرار الكتابات المحسوبة، و**هذه المهمة** تغطي من الاستلام حتى الالتزام، و**مهمة الإيقاظ** هي عملية الإيقاظ التي نفّذتها. وينقسم مسار المهمة إلى انتظار الطابور، والاستلام / الإعداد، والحساب. كما تفرّغ مهمة الإيقاظ عملًا مستحقًا آخر على قاعدة البيانات نفسها، لذا يكون امتدادها أطول من المسار الكامل في العادة. | +| **سلسلة المهام** | كل مهمة في التسلسل، متداخلة تحت المهمة التي أدرجتها في قائمة الانتظار، حتى تتمكن من معرفة مصدر كل فرع. أما الدفعات الجزئية المتفرعة من المرحلة نفسها فهي طابور تسلسلي وتبقى في مستوى واحد بدلًا من التداخل الأعمق. ويعرض كل صف حالته وخطوات الخطة و**هدف الكتابة** (الجدول والحقول التي تحدّثها المهمة) و**التعقيد المقدّر** وعمق التسلسل ووقت الإدراج والمدة. | | **انتشار الحقول** | الحقول التي قرأها التشغيل وكتبها، وكيف انتقل التغيير بينها. يمثل الأزرق المتقطع الأصل الذي أدى إلى هذه الكتابة، والرمادي مدخلًا لم يُكتب في هذا التشغيل، والأخضر ما كُتب في هذا التشغيل، وتمثل الأسهم تبعيات الحقول أو انتقالات الارتباط لا ترتيب الخطوات. لا تُرسم إلا الأصول التي تصل فعليًا إلى كتابات هذا التشغيل. استخدم **توسيع** لفتح الرسم بملء الشاشة عندما يصعب تتبع سلسلة عريضة داخل الصفحة. | لا يسجل دفتر المسار إلا المهام التي أُنشئت بعد إصدار هذه الميزة، ويحتفظ بسجل لمدة 7 أيام. تعرض المهمة الأقدم بيانات قائمة الانتظار من دون رسم انتشار. ولا تعرض المهمة الأولية التي لم يخطط لها العامل بعد إلا حقول تشغيلها. عندما لا ينتج عن تغيير أي كتابات محسوبة لاحقة، يوضح الرسم ذلك: لم يعتمد شيء على تلك الحقول من خلال صيغة أو بحث أو تجميع أو عنوان ارتباط. diff --git a/ar/basic/admin-panel/overview.mdx b/ar/basic/admin-panel/overview.mdx index 84b37856..929c3762 100644 --- a/ar/basic/admin-panel/overview.mdx +++ b/ar/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ description: "تُستخدم لوحة إدارة Teable ذاتية الاستض ### العمليات والتدقيق - **[إدارة الأتمتة](/ar/basic/admin-panel/automation-management)**: عرض حالة تشغيل الأتمتة وسجل التشغيل -- **[عمليات استعلام الجداول](/ar/basic/admin-panel/table-query-ops)**: تحليل مخاطر استعلامات الجداول وتوصيات الفهارس +- **[عمليات استعلام الجداول](/ar/basic/admin-panel/table-query-ops)**: ضبط تغطية البحث لكل جدول، وإنشاء الفهارس، ومتابعة النتائج - **[صندوق المهام المحسوبة](/ar/basic/admin-panel/computed-outbox)**: مراقبة تسليم المهام المحسوبة وسلامة قائمة الانتظار وتراكم قاعدة البيانات - **[قائمة انتظار توليد الذكاء الاصطناعي](/ar/basic/admin-panel/ai-generation-queue)**: مراجعة حالة توليد حقول الذكاء الاصطناعي في النسخة ذاتية الاستضافة الحالية - **[وكيل البيئة المعزولة](/ar/basic/admin-panel/sandbox-agent)**: تهيئة وكيل البيئة المعزولة وإدارته diff --git a/ar/basic/admin-panel/table-query-ops.mdx b/ar/basic/admin-panel/table-query-ops.mdx index 8c4b04f5..dbfa1c71 100644 --- a/ar/basic/admin-panel/table-query-ops.mdx +++ b/ar/basic/admin-panel/table-query-ops.mdx @@ -1,85 +1,74 @@ --- title: "عمليات استعلام الجداول" -description: "راجع توصيات مخاطر الاستعلام للجداول البطيئة وأكّد تحسينات قاعدة البيانات." +description: "راجع تغطية البحث والفهارس لكل جدول، واضبط البحث، وأنشئ الفهارس، وتابع النتائج." --- متاحة لخطة Business ذاتية الاستضافة والخطط الأعلى المسار: لوحة الإدارة ← عمليات استعلام الجداول -استخدم **عمليات استعلام الجداول** عندما تصبح طرق العرض أو عوامل التصفية أو العلاقات أو عمليات البحث في جدول كبير بطيئة. يراقب محلل في الخلفية حمل الاستعلام ويحوّل ملاحظاته إلى توصيات. تسردها الصفحة حتى يراجع مسؤولو النسخة الأدلة ويحللوا جدولًا محددًا بعمق ويؤكدوا أي تغيير في قاعدة البيانات. +استخدم **بحث الجداول والفهارس** عندما تصبح طرق العرض أو عوامل التصفية أو العلاقات أو عمليات البحث في جدول كبير بطيئة. يراقب Teable حمل الاستعلامات في الخلفية ويلخّص حالة كل جدول: كيف يجري البحث فيه حاليًا، وأي الحقول مشمولة بالتغطية، وأي فهارس فعلية موجودة، وكم عدد الاستعلامات البطيئة التي رُصدت مؤخرًا. ومن هنا يضبط مسؤولو النسخة تغطية البحث، وينشئون الفهارس، ويتابعون النتائج. -تلخص العدادات أعلى القائمة الوضع الحالي: نوافذ المراقبة والطلبات والاستعلامات البطيئة والمهل المنتهية والتوصيات المفتوحة والمقبولة والمهام الجارية والفاشلة وعدد مسارات الوصول للبحث الجاهزة أو المتدهورة. +تكتفي الصفحة بإدراج المهام ولا تغيّر قاعدة البيانات مباشرةً أبدًا. ويُنفَّذ كل تغيير في الخلفية بشكل غير متزامن، لذا تحقق من النتيجة في **المهام / السجل**. -## مراجعة التوصيات +## العثور على الجدول المطلوب -تُفتح الصفحة على **التوصيات** مرتبة حسب الأولوية. يوازن المحلل بين مخاطر الاستعلام وكثافة استخدام الجدول، فتظهر أولًا الإدخالات الأجدر بالتنفيذ. +تُفتح الصفحة على قائمة الجداول. وتحمل أزرار الحالة في الأعلى أعدادها الخاصة وتضيّق القائمة: -ابحث حسب معرّف الجدول أو قاعدة البيانات أو المساحة لتصفية جميع التوصيات؛ ويصفّي أي نص آخر ما يظهر على الشاشة. وتضيّق عوامل تصفية الحالة والمخاطر القائمة أكثر. - -يسمي كل إدخال المساحة وقاعدة البيانات والجدول التابع لها. وسّع صفًا لقراءة الأدلة والتفسير وبيانات SQL التشخيصية: - -| القسم | ما يوضحه | +| الحالة | المعنى | | --- | --- | -| **المشغّل** | مصدر التوصية: حركة استعلام مرصودة أو تهيئة طريقة عرض محفوظة أو تهيئة حقل علاقة. لا يعني مشغّل طريقة العرض المحفوظة رصد استعلام بطيء؛ فالتهيئة وحدها رفعت المخاطر. | -| **مسار الوصول** | مرات الوصول إلى الجدول بالمسح التسلسلي مقارنة بمسح الفهرس. | -| **الأسباب** | أسباب مقروءة مثل كبر الجدول أو غياب فهرس مفيد لحقول التصفية أو الفرز أو ارتفاع تكلفة الفرز أو رصد انتهاء المهلة. | -| **شكل الاستعلام** | الحقول المحددة التي تُصفّى وتُرتب ونوع المطابقة المستخدم لكل منها. | -| **الفهرس المقترح** | الحقول التي ستفهرسها التوصية والسبب. | +| **جميع الجداول** | كل الجداول المرصودة. | +| **يحتاج إلى انتباه** | جداول بها استعلامات بطيئة أو مهلات منتهية أو توصيات معلّقة أو مهام فاشلة. ابدأ من هنا. | +| **البحث المفهرس** | جداول سبق ضبط تغطية البحث لها. | +| **غير مضبوط** | جداول بلا تغطية بحث بعد. | +| **غير متاح** | جداول لا يمكنها استخدام البحث المفهرس حاليًا، ويوضّح الصف السبب. | -يفتح **التحليل المتعمق** مساحة عمل التحليل مع تعبئة ذلك الجدول مسبقًا. +يقبل مربع البحث أسماء الجداول وقواعد البيانات والمساحات أو معرّفاتها. ويكون الترتيب حسب **الأكثر استعلامات بطيئة** أو **اسم الجدول**. وتغطي **نافذة الرصد** آخر ساعة أو 24 ساعة أو 7 أيام، وتتبع كل أرقام الرصد في القائمة هذه النافذة. -عندما يرصد المحلل بحثًا كثيفًا بسلاسل فرعية عبر جدول، ينشئ توصية واحدة من نوع **GIN للنص المنشأ** للجدول كله بدل فهرس لكل حقل. يعرض هذا الصف **إنشاء مسار بحث** بدل **التحليل المتعمق**، ولا يظهر **إضافة فهرس**. وتُغلق التوصية تلقائيًا بعد حصول الجدول على المسار. +يعرض كل صف عدد الصفوف والحجم التقديريين للجدول، والطلبات والاستعلامات البطيئة ضمن النافذة، وطريقة البحث الحالية وتغطية الحقول، وعدد فهارس التصفية/الفرز، إضافة إلى عدد التوصيات المعلّقة والمهام النشطة. انقر اسم الجدول لفتح تفاصيله. -ينفذ **إنشاء مسار بحث** تحليلًا تجريبيًا (dry run) للجدول داخل نافذة في الصفحة نفسها، دون مغادرتها. تعرض النافذة مزود الفهرس المرشح وعدد الحقول المغطاة وعدد الصفوف التقديري وتكلفة `EXPLAIN` قبل التغيير وبعده. أدخل نموذج بحث لا يقل طوله عن الحد الأدنى المعروض؛ يُستخدم للتحقق فقط ولا يُحفظ. وفي الجداول الكبيرة، أكد أيضًا خانة نافذة الصيانة. بعد التأكيد يُعاد التحقق من المرشح ثم يُفعَّل مسار البحث. +## ضبط تغطية البحث -وإذا لم ينتج التحليل أي مرشح، تشرح النافذة السبب ولا تنفذ شيئًا. تُرفض الجداول العريضة لأن Teable لا ينشئ لها مستند بحث يغطي كل الحقول، ولن يغيّر ذلك إدخال نموذج بحث أطول. انقر عندها على **تحليل الحقول المحددة** للانتقال إلى مساحة التحليل وتحليل الحقول التي يبحث فيها المستخدمون فعلًا. +تعرض علامة التبويب **تغطية البحث** طريقة البحث الحالية للجدول، وعدد الحقول المشمولة، وحالة التغطية لكل حقل. ويقصر خيار **عرض الحقول غير المشمولة** القائمة على الحقول التي لم تُضمَّن بعد؛ أما الحقول المعلَّمة بـ **غير مؤهل** فلا يمكنها المشاركة في فهرس البحث الجزئي. -توجد علامتا تبويب إضافيتان بجوارها: +التغطية تحدَّد صراحةً. فالحقول التي تضيفها لاحقًا لا تُضمَّن تلقائيًا، ويلزم ضبط الجدول من جديد لإدراجها. أما عمليات البحث خارج نطاق التغطية، أو التي يكون فيها نص البحث قصيرًا جدًا، فترجع إلى فحص `ILIKE` الأبطأ. -| علامة التبويب | ما تعرضه | -| --- | --- | -| **الجداول النشطة** | أكثر الجداول انشغالًا مع الطلبات والاستعلامات البطيئة والمهل المنتهية وأطول مدة استعلام. | -| **المهام** | مهام المعالجة التي أنشأها Teable، مع الحالة والمحاولات والعامل وآخر خطأ. | +اختر **ضبط البحث** للجدول الذي لم يُضبط من قبل، أو **تحديث التحديد / إعادة البناء** للجدول المضبوط سابقًا. ويطلب مربع الحوار ما يلي: -يظهر شريط أعلى القائمة عندما تعوق مشكلة تهيئة العملية: قد تكون مسارات البحث مهيأة مع تعطيل علامة التشغيل، أو قد تملك بعض الجداول مسارًا قديمًا أو بانتظار إعادة البناء فعاد بحثها بصمت إلى مسح `ILIKE` الأبطأ، أو تكون أقدم مهمة منتظرة قد طال انتظارها بما يوحي بعدم وجود عامل يستهلكها. أصلح ما يورده الشريط قبل تنفيذ التوصيات. +| العنصر | ما تُدخله | +| --- | --- | +| **مزوّد البحث** | `pg_bigm` أو `pg_trgm`. وإذا كان الامتداد غير مثبّت، يوضّح مربع الحوار ما الذي ينقص ومن يمكنه توفيره. | +| **نص بحث تمثيلي** | نص يبحث عنه المستخدمون فعليًا. يُستخدم للتحقق من دلالات البحث الجزئي وجمع أدلة خطة التنفيذ، ولا يُحفظ إطلاقًا. وإذا كان قصيرًا جدًا، يذكر مربع الحوار الحد الأدنى المطلوب. | +| **الحقول** | حدّد الحقول التي يبحث فيها المستخدمون فعلًا. ولا تحدّد كل الحقول في جدول عريض، فبناء مستند بحث لكل حقل مكلف. | -### قراءة شارة القرار +يشغّل **التحليل والتشغيل التجريبي** التغيير دون اعتماده، ويذكر عدد الحقول المشمولة، وعدد الصفوف التقديري، ووجود أدلة من خطة التنفيذ من عدمه، وأثر الإنشاء أو إعادة البناء. أما الجداول المقدّرة بـ 50,000 صف فأكثر، أو المجهولة الحجم، فتتطلب أيضًا تأكيد نافذة الصيانة. ثم اختر **تأكيد وإدراج المهمة**. -تحمل كل توصية أحدث قرار اتخذه النظام بشأنها: +ينشئ إنشاء تغطية البحث أو إعادة بنائها عمود بحث وفهرس GIN. وقد يعيد ذلك كتابة الجدول بالكامل ويحتفظ بأقفال، وينقطع البحث المفهرس لفترة قصيرة أثناء التنفيذ. لذا خطّط لذلك ضمن نافذة صيانة. -| الشارة | المعنى | -| --- | --- | -| **تحتاج إلى تأكيد يدوي** | لا يمكن تطبيقها إلا لمسؤول. | -| **ظل · ستعمل تلقائيًا** | تستوفي التوصية معايير القبول، لكن التنفيذ التلقائي غير مفعّل، فلم يتغير شيء. | -| **قيد التنفيذ التلقائي** / **نُفذت تلقائيًا** | قبل التنفيذ التلقائي التوصية وطبقها. | -| **فشل التحقق اللاحق · تراجع مؤقت** | لم يجتز تغيير تلقائي التحقق. ينتظر Teable مدة أطول قبل إعادة محاولة الجدول. | -| **فترة تهدئة** | تغير النطاق نفسه مؤخرًا، لذا ينتظر النظام. | -| **معلقة** / **لم يُطبق التنفيذ التلقائي** | لم تبلغ أدلة الخطة أو حجم الجدول حد التنفيذ التلقائي. | +ما يعيده مربع الحوار هو إيصال بإدراج المهمة، لا نتيجة تنفيذها. أغلقه وتابع المهمة في **المهام / السجل**. وإذا أرسلت التغيير نفسه مرة أخرى، تُعاد المهمة القائمة. -لا يسجل Teable افتراضيًا إلا القرارات وينشئ سجلات التوصيات والمهام، ولا يغير قاعدة بياناتك تلقائيًا. التنفيذ التلقائي اختياري عبر `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`، وحتى عند تمكينه لا يطبق إلا على الجداول الصغيرة التي تُظهر خطة تنفيذها تحسنًا واضحًا في التكلفة. أما البقية فتنتظر مسؤولًا. +## إدارة فهارس التصفية والفرز -### إضافة الفهرس المقترح +تسرد علامة التبويب **فهارس التصفية / الفرز** الفهارس الفعلية التي تخدم شروط التصفية والفرز في هذا الجدول، مع صلاحية كل فهرس، وما إذا كان Teable يديره، وحجمه وتعريفه. وتُدار هذه الفهارس بمعزل عن فهارس البحث الجزئي. -عندما توافق على فهرس مقترح، انقر على **إضافة فهرس** في الصف. يؤدي التأكيد إلى قبول التوصية وتشغيل `CREATE INDEX CONCURRENTLY` على جدول PostgreSQL الأساسي؛ وإذا جرى تخطي التحقق من الخطة، يبني Teable الفهرس من الحقول الموصى بها. يكرر مربع الحوار الأدلة للمراجعة الأخيرة. +وتضم **الإجراءات المعلّقة** أدناه توصيات الفهارس الصادرة عن النظام، مع بيان ما إذا كانت مدعومة بأدلة من خطة التنفيذ. ويعرض **مراجعة إنشاء الفهرس** الفهرس المقترح وقاعدة البيانات التي سيُنفَّذ عليها والأدلة المتاحة؛ وبعد التأكيد ينفّذ Teable الأمر `CREATE INDEX CONCURRENTLY` بشكل غير متزامن. وتتطلب الجداول الكبيرة والمجهولة الحجم تأكيد نافذة الصيانة هنا أيضًا. -بالنسبة إلى جدول يُقدّر بأنه يضم 50,000 صف أو أكثر، يطلب مربع الحوار تأكيد وجود نافذة صيانة قبل إتاحة الزر. يستغرق البناء المتزامن لجدول كبير وقتًا ويضيف حملًا أثناء التنفيذ. +لا تحذف هذه الصفحة الفهارس. فالفهارس غير المُدارة وفهارس النظام قد تحمي قيودًا أو تخدم أحمال عمل أخرى، ولذلك تُترك كما هي. -يعرض Teable بعدها **أُنشئ الفهرس** أو **قُبلت التوصية وأُدرجت في قائمة الانتظار**. في الحالة الثانية، تابع المهمة ضمن **المهام**. إذا لم يكن للتوصية عمود فعلي قابل للتنفيذ، يظل **إضافة فهرس** معطلًا ويوضح السبب؛ استخدم مساحة التحليل لمزيد من البحث. +## تشخيص استعلامات بعينها -## إجراء تحليل متعمق +عندما يُبلَّغ عن بطء جدول ولا توجد توصية تغطيه، افتح علامة التبويب **تشخيص الاستعلامات** واختر **تحليل الاستعلامات**. ويكتفي التحليل بقراءة أشكال الاستعلامات المحفوظة وأدلة خطة التنفيذ المتاحة، ولا ينشئ شيئًا. -افتح **مساحة عمل التحليل** لتحليل نطاق عند الطلب، مثل إبلاغ مستخدم عن جدول بطيء لا يملك توصية بعد. +وتكون النتيجة إحدى ثلاث: **عُثر على فرص فهرسة مدعومة بخطة التنفيذ**، أو **لم تؤكد الخطط المتاحة أي فرصة فهرسة**، أو **أدلة غير كافية**. ولا تعني الأدلة غير الكافية أن فحصًا تسلسليًا قد حدث، فرصد استعلام بطيء وحده لا يثبت أن مسار الوصول هو السبب. ويُدرج أسفل ذلك كل استعلام متأثر، مع بيان ما إذا كان واردًا من حركة فعلية أو من إعداد طريقة عرض محفوظة، وتكلفة الخطة التقديرية قبل الفهرس المقترح وبعده (تكلفة خطة، لا أجزاء من الثانية). -| نوع التحليل | الاستخدام | -| --- | --- | -| **الاستعلامات والفهارس** | العثور على مخاطر الاستعلام وتحسينات الفهرس الممكنة. | -| **بحث السلسلة الفرعية** | التحقق مما إذا كان مسار وصول للبحث بسلسلة فرعية يسرّع عمليات البحث «يحتوي على» من دون تغيير سلوك المطابقة. | +## متابعة النتائج -اختر **جدولًا** أو **قاعدة بيانات** أو **مساحة**، وأدخل المعرّف الموافق وحدد نوع التحليل. ابدأ بـ **جدول** عندما تعرف الجدول البطيء. +تضم علامة التبويب **المهام / السجل** ثلاثة أقسام: -انقر على **إنشاء تقرير استعلام** أو **إنشاء تقرير بحث**. يلخص التقرير المخاطر والإجراءات التالية الموصى بها. في تقرير البحث، يكون **نموذج بحث EXPLAIN** اختياريًا. أضف نموذجًا للتحقق من توافق النتائج وخطط الاستعلام وتوقيت الاستعلام المتكرر لمسار البحث المقترح. لا يحفظ Teable قيمة النموذج. +- **المهام**: مهام الخلفية الخاصة بهذا الجدول، مع الحالة وعدد المحاولات ونوع المهمة وسبب الفشل. وإذا نجحت المهمة في النهاية بعد فشل سابق، يُعلَّم الخطأ بأنه محاولة سابقة. +- **سجل إعدادات البحث**: المزوّد والحالة وقائمة الحقول لكل إعداد تغطية سابق. +- **سجل التوصيات**: التوصيات المقبولة أو المتجاهَلة أو المستبدَلة. -لا يغير تقرير الاستعلام قاعدة البيانات. يتطلب تطبيق توصية بحث السلسلة الفرعية **نموذج بحث EXPLAIN** وتأكيد المسؤول. +لا يُحمَّل من السجل سوى أحدث الإدخالات. وإذا كان هناك المزيد، يذكر سطر أعلى القائمة العدد الإجمالي. -بالنسبة إلى جدول كبير، راجع الأثر وجدول أي تغيير مؤكد ضمن نافذة صيانة مناسبة. +ما دامت للجدول مهمة مدرجة أو قيد التشغيل، يظل زرّا ضبط البحث وإنشاء الفهارس معطَّلين. انتظر انتهاء المهمة. diff --git a/ar/basic/credential.mdx b/ar/basic/credential.mdx index 7268d650..664cd02b 100644 --- a/ar/basic/credential.mdx +++ b/ar/basic/credential.mdx @@ -26,7 +26,7 @@ description: أدر اتصالاتك وأسرارك وامنحها للتطبي يُضاف الاتصال عبر **ربط حساب جديد**. وعند انتهاء صلاحية التصريح، يظهر في الاتصال زر **إعادة الربط**. -يبيّن كل عنصر عدد الموارد التي تستخدمه حاليًا. ويفتح زر **عرض** قائمة التطبيقات والأتمتة، حيث يمكنك **إزالة التفويض** عن أي عنصر منها. +يبيّن كل عنصر عدد الموارد التي تستخدمه حاليًا. ويفتح زر **عرض** قائمة التطبيقات والأتمتة، مع وقت منح التفويض لكل عنصر، حيث يمكنك **إزالة التفويض** عن أي عنصر منها. ## منح بيانات اعتماد لتطبيق أو أتمتة diff --git a/ar/basic/field/common/show-as.mdx b/ar/basic/field/common/show-as.mdx index 8dc90dcd..ba406079 100644 --- a/ar/basic/field/common/show-as.mdx +++ b/ar/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "العرض التفاعلي" -description: "غيّر عرض قيمة الحقل وسلوك النقر، مثل عناوين URL ورسائل البريد الإلكتروني وأرقام الهواتف ومخططات الأرقام." +description: "غيّر عرض قيمة الحقل وسلوك النقر، مثل رسائل البريد الإلكتروني وأرقام الهواتف ومخططات الأرقام." --- يغيّر العرض التفاعلي كيفية ظهور قيم الحقول وتصرفها عند النقر عليها. ولا يغيّر نوع الحقل، بل يغيّر فقط كيفية عرض المستخدمين لمحتوى الحقل وتفاعلهم معه. @@ -9,7 +9,6 @@ description: "غيّر عرض قيمة الحقل وسلوك النقر، مثل | العرض | الوصف | | --- | --- | -| عنوان URL | يعرض النص كعنوان ويب. ويؤدي النقر عليه إلى فتح الرابط في متصفح | | بريد إلكتروني | يعرض النص كعنوان بريد إلكتروني. ويؤدي النقر عليه إلى فتح تطبيق البريد الافتراضي | | هاتف | يعرض النص كرقم هاتف. ويؤدي النقر عليه إلى بدء إجراء اتصال، بحسب دعم الجهاز | diff --git a/ar/basic/field/long-text.mdx b/ar/basic/field/long-text.mdx index f25e3d82..cb84090b 100644 --- a/ar/basic/field/long-text.mdx +++ b/ar/basic/field/long-text.mdx @@ -46,5 +46,5 @@ description: "خزّن نصوصًا طويلة تتضمن فواصل أسطر، ## ملاحظات -- لا يدعم حقل نص طويل العرض التفاعلي لعناوين URL أو البريد الإلكتروني أو الهاتف. فهو يدعم النص العادي وMarkdown فقط. -- إذا كان المحتوى لا يحتاج إلى فواصل أسطر وينبغي أن يستخدم عرض URL أو البريد الإلكتروني أو الهاتف، فاستخدم حقل **نص أحادي السطر**. +- تتحول عناوين الويب داخل النص إلى روابط قابلة للنقر تلقائيًا، دون أي إعداد. وعند توسيع السجل، يعرض زر بجوار حقل الإدخال جميع العناوين الموجودة في الخلية. +- لا يدعم حقل نص طويل العرض التفاعلي للبريد الإلكتروني أو الهاتف. استخدم حقل **نص أحادي السطر** إذا أردت النقر على عنوان أو رقم لإرسال رسالة أو إجراء مكالمة. diff --git a/ar/basic/field/single-line-text.mdx b/ar/basic/field/single-line-text.mdx index 6f335acb..eefdf528 100644 --- a/ar/basic/field/single-line-text.mdx +++ b/ar/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ description: "خزّن نصوصًا قصيرة مثل الأسماء والعن +## الكشف التلقائي عن الروابط + +تتحول عناوين الويب داخل الخلية إلى روابط قابلة للنقر تلقائيًا، دون أي إعداد. ويتعرّف Teable على العناوين التي تبدأ بـ `https://` أو `www.`، وكذلك النطاقات الشائعة مثل `teable.ai`. وإذا احتوت القيمة على عدة عناوين، يصبح كل عنوان رابطًا مستقلًا. وعند توسيع السجل، يعرض زر بجوار حقل الإدخال جميع العناوين الموجودة في الخلية. + +ولا تُعدّ أسماء الملفات وأرقام الإصدارات مثل `readme.md` أو `v1.2.3` عناوين ويب. + ## وضع العرض -يدعم حقل نص أحادي السطر أربعة أوضاع عرض: +يدعم حقل نص أحادي السطر ثلاثة أوضاع عرض: | وضع العرض | مناسب لـ | السلوك عند النقر | | --- | --- | --- | -| افتراضي | الأسماء، والعناوين، والمعرّفات، وغيرها من النصوص العادية | لا يوجد سلوك إضافي عند النقر | -| URL | عناوين الويب | يفتح عنوان URL في المتصفح الافتراضي | +| افتراضي | الأسماء، والعناوين، والمعرّفات، وغيرها من النصوص العادية | تتحول عناوين الويب إلى روابط تُفتح عند النقر | | البريد الإلكتروني | عناوين البريد الإلكتروني | يفتح تطبيق البريد الإلكتروني الافتراضي | | الهاتف | أرقام الهاتف | يفتح تطبيق الاتصال على الجهاز. وعلى الهاتف المحمول، يمكن للمستخدمين الاتصال بالرقم مباشرةً | @@ -45,7 +50,7 @@ description: "خزّن نصوصًا قصيرة مثل الأسماء والعن ## الاستخدامات الشائعة -- **إدارة معلومات اتصال العملاء**: أنشئ حقل "موقع الشركة" واضبطه على **URL** لفتح الموقع عند النقر عليه. وأنشئ حقل "الهاتف" واضبطه على **الهاتف** كي يتمكن مستخدمو الأجهزة المحمولة من الاتصال بنقرة واحدة. +- **إدارة معلومات اتصال العملاء**: أنشئ حقل "موقع الشركة" واكتب العنوان فيه لفتح الموقع عند النقر عليه. وأنشئ حقل "الهاتف" واضبطه على **الهاتف** كي يتمكن مستخدمو الأجهزة المحمولة من الاتصال بنقرة واحدة. - **إدارة الطلبات أو العقود**: أنشئ حقل "معرّف الطلب" أو "معرّف العقد" للبحث والتصفية والمطابقة مع الأنظمة الخارجية. - **الحالة الأولية للتذكرة**: أنشئ حقل "المرحلة الحالية" وعيّن القيمة الافتراضية على "جديد". وإذا كانت المرحلة تأتي من سير عمل ثابت، فاستخدم حقل **تحديد أحادي** بدلًا منه. - **استخراج النص وربطه**: ارجع إلى حقل نص أحادي السطر في الصيغ لاستخراج أجزاء المعرّف، أو ربط أسماء العرض، أو توحيد تنسيق النص. @@ -53,5 +58,5 @@ description: "خزّن نصوصًا قصيرة مثل الأسماء والعن ## ملاحظات - حقل نص أحادي السطر مخصص للمحتوى القصير. وعادةً ما يؤكد مفتاح Enter الإدخال. استخدم **نص طويل** للملاحظات وملخصات المقالات وغيرها من المحتويات الطويلة. -- URL والبريد الإلكتروني والهاتف هي أوضاع عرض. ويظل نوع الحقل نصًا أحادي السطر ويمكن الاستمرار في فرزه وتصفيته ومعالجته بدوال النص. +- البريد الإلكتروني والهاتف هما وضعا عرض. ويظل نوع الحقل نصًا أحادي السطر ويمكن الاستمرار في فرزه وتصفيته ومعالجته بدوال النص. - لا يقيّد حقل نص أحادي السطر القيم بخيارات محددة مسبقًا. استخدم **تحديد أحادي** أو **تحديد متعدد** للحالات والفئات والأولويات التي تحتاج إلى قيم متسقة. diff --git a/de/basic/admin-panel/computed-outbox.mdx b/de/basic/admin-panel/computed-outbox.mdx index 31a664d5..9b45651f 100644 --- a/de/basic/admin-panel/computed-outbox.mdx +++ b/de/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ Wenn ein berechneter Wert falsch aussieht oder verspätet eingetroffen ist, öff | Abschnitt | Was er beantwortet | | --- | --- | | Zusammenfassung | End-to-End-Latenz, Zeitpunkt der Quelländerung, Zeitpunkt der Konvergenz des Werts sowie Tabelle und Felder, die die Ausführung ausgelöst haben. Eine Plakette **Wird berechnet** bedeutet, dass die Kette noch läuft. | -| **Zeitachse** | Wann die Ausführung eingereiht, gestartet und abgeschlossen wurde oder fehlgeschlagen ist. | -| **Aufgabenkette** | Jede Aufgabe in der Kaskade, unter der Aufgabe verschachtelt, die sie eingereiht hat, damit Sie sehen können, woher ein Zweig stammt. Jede Zeile zeigt ihren Zustand, Plan-Schritte, **Schreibziel** (die Tabelle und Felder, die diese Aufgabe aktualisiert), **Unsaubere Zeilen**, Kaskadentiefe, Einreihungszeit und Dauer. | +| **Zeitachse** | Drei Spuren nebeneinander: **Ende-zu-Ende** reicht von der Quelländerung bis zum Setzen der berechneten Schreibvorgänge, **Dieser Task** umfasst Claim bis Commit, und **Wakeup-Job** ist der Aufweckvorgang, der ihn ausgeführt hat. Die Task-Spur ist in Wartezeit, Claim / Setup und Berechnung unterteilt. Der Wakeup-Job arbeitet zusätzlich fällige Arbeit derselben Datenbank ab und dauert deshalb normalerweise länger als Ende-zu-Ende. | +| **Aufgabenkette** | Jede Aufgabe in der Kaskade, unter der Aufgabe verschachtelt, die sie eingereiht hat, damit Sie sehen können, woher ein Zweig stammt. Teilbatches derselben Stufe sind eine serielle Warteschlange und stehen flach auf einer Ebene, statt weiter verschachtelt zu werden. Jede Zeile zeigt ihren Zustand, Plan-Schritte, **Schreibziel** (die Tabelle und Felder, die diese Aufgabe aktualisiert), **Geschätzte Komplexität**, Kaskadentiefe, Einreihungszeit und Dauer. | | **Feldausbreitung** | Welche Felder die Ausführung gelesen und geschrieben hat und wie die Änderung zwischen ihnen weitergegeben wurde. Gestrichelt blau ist der Ursprung, der zu diesem Schreiben führte, grau ist eine Eingabe, die bei dieser Ausführung nicht geschrieben wurde, grün wurde bei dieser Ausführung geschrieben, und die Pfeile sind Feldabhängigkeiten oder Verknüpfungssprünge statt der Reihenfolge der Schritte. Es werden nur Ursprünge gezeichnet, die tatsächlich die Schreibvorgänge dieser Ausführung erreichen. Verwenden Sie **Erweitern**, um das Diagramm im Vollbild zu öffnen, wenn eine breite Kette inline schwer nachzuverfolgen ist. | Das Herkunfts-Ledger zeichnet nur Aufgaben auf, die nach Veröffentlichung dieser Funktion erstellt wurden, und bewahrt 7 Tage Verlauf auf. Eine ältere Aufgabe zeigt ihre Warteschlangenfakten ohne Ausbreitungsdiagramm. Eine Seed-Aufgabe, die der Worker noch nicht geplant hat, zeigt nur ihre Auslöserfelder. Wenn eine Änderung keine nachgelagerten berechneten Schreibvorgänge erzeugt hat, wird dies im Diagramm angegeben: Nichts hing über eine Formel, ein Lookup, ein Rollup oder einen Verknüpfungstitel von diesen Feldern ab. diff --git a/de/basic/admin-panel/overview.mdx b/de/basic/admin-panel/overview.mdx index 197a4fd2..9bb8fc87 100644 --- a/de/basic/admin-panel/overview.mdx +++ b/de/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ Das Admin-Panel gruppiert seine Seiten nach Zweck: ### Betrieb und Prüfung - **[Automatisierungsverwaltung](/de/basic/admin-panel/automation-management)**: Ausführungsstatus und Ausführungsverlauf von Automatisierungen anzeigen -- **[Table Query Ops](/de/basic/admin-panel/table-query-ops)**: Risiken bei Tabellenabfragen und Indexempfehlungen analysieren +- **[Table Query Ops](/de/basic/admin-panel/table-query-ops)**: Suchabdeckung je Tabelle konfigurieren, Indizes erstellen und Ergebnisse verfolgen - **[Computed Outbox](/de/basic/admin-panel/computed-outbox)**: Zustellung berechneter Aufgaben, Warteschlangenzustand und Datenbankrückstau überwachen - **[KI-Generierungswarteschlange](/de/basic/admin-panel/ai-generation-queue)**: Status der KI-Feldgenerierung in der aktuellen selbst gehosteten Instanz prüfen - **[Sandbox-Agent](/de/basic/admin-panel/sandbox-agent)**: Sandbox-Agent konfigurieren und verwalten diff --git a/de/basic/admin-panel/table-query-ops.mdx b/de/basic/admin-panel/table-query-ops.mdx index 690ff5e4..5e7fb054 100644 --- a/de/basic/admin-panel/table-query-ops.mdx +++ b/de/basic/admin-panel/table-query-ops.mdx @@ -1,86 +1,74 @@ --- title: "Tabellenabfrage-Operationen" -description: "Prüfen Sie Empfehlungen zum Abfragerisiko für langsame Tabellen und bestätigen Sie Datenbankverbesserungen." +description: "Suchabdeckung und Indizes tabellenweise prüfen, Suche konfigurieren, Indizes erstellen und Ergebnisse verfolgen." --- Verfügbar ab dem selbst gehosteten Business-Tarif Pfad: Admin-Panel → Tabellenabfrage-Operationen -Verwenden Sie **Tabellenabfrage-Operationen**, wenn Ansichten, Filter, Beziehungen oder Suchen in einer großen Tabelle langsam werden. Ein Hintergrundanalysator überwacht die Abfragelast und erstellt aus seinen Beobachtungen Empfehlungen. Die Seite führt diese auf, damit Instanzadministratoren die Nachweise prüfen, eine bestimmte Tabelle eingehender analysieren und jede Datenbankänderung bestätigen können. +Verwenden Sie **Tabellensuche und Indizes**, wenn Ansichten, Filter, Beziehungen oder Suchen in einer großen Tabelle langsam werden. Teable beobachtet die Abfragelast im Hintergrund und fasst jede Tabelle zusammen: wie sie derzeit durchsucht wird, welche Felder abgedeckt sind, welche physischen Indizes vorhanden sind und wie viele langsame Abfragen zuletzt beobachtet wurden. Instanzadministratoren konfigurieren hier die Suchabdeckung, erstellen Indizes und verfolgen die Ergebnisse. -Die Zähler über der Liste fassen die aktuelle Lage zusammen: Beobachtungsfenster, Anfragen, langsame Abfragen, Zeitüberschreitungen, offene und angenommene Empfehlungen, laufende und fehlgeschlagene Aufgaben sowie die Anzahl der bereiten oder beeinträchtigten Suchzugriffspfade. +Die Seite stellt nur Aufgaben ein und ändert die Datenbank nie direkt. Jede Änderung läuft asynchron im Hintergrund, prüfen Sie das Ergebnis daher unter **Aufgaben / Verlauf**. -## Empfehlungen prüfen +## Die passende Tabelle finden -Die Seite öffnet sich mit **Empfehlungen**, nach Priorität sortiert. Der Analysator bewertet das Risiko einer Abfrage im Verhältnis dazu, wie stark die Tabelle genutzt wird. Daher stehen die Einträge mit dem größten Handlungsbedarf zuerst. +Die Seite öffnet sich mit der Tabellenliste. Die Statusschaltflächen oben tragen jeweils eigene Zähler und grenzen die Liste ein: -Suchen Sie nach Tabellen-, Base- oder Space-ID, um alle Empfehlungen zu filtern; anderer Text filtert, was bereits auf dem Bildschirm angezeigt wird. Die Status- und Risikofilter grenzen die Liste weiter ein. - -Jeder Eintrag nennt den zugehörigen Space, die Base und die Tabelle. Klappen Sie eine Zeile auf, um die Nachweise hinter der Empfehlung, die Systementscheidung und die SQL-Diagnostik zu lesen: - -| Abschnitt | Aussage | +| Status | Bedeutung | | --- | --- | -| **Auslöser** | Woher die Empfehlung stammt: beobachteter Abfrageverkehr, eine gespeicherte Ansichtskonfiguration oder eine Beziehungskonfiguration für ein Feld. Ein Auslöser durch eine gespeicherte Ansicht bedeutet, dass noch keine langsame Abfrage beobachtet wurde; allein die Konfiguration hat das Risiko ausgelöst. | -| **Zugriffspfad** | Wie häufig diese Tabelle über einen sequenziellen Scan gegenüber einem Indexscan erreicht wurde. | -| **Gründe** | Verständliche Ursachen wie eine große Tabelle, kein nützlicher Index für die Filter- oder Sortierfelder, aufwendige Sortierung oder beobachtete Zeitüberschreitungen. | -| **Abfragestruktur** | Die konkret gefilterten und sortierten Felder sowie die jeweils verwendete Art der Übereinstimmung. | -| **Vorgeschlagener Index** | Die Felder, die die Empfehlung indexieren würde, und warum. | +| **Alle Tabellen** | Alle beobachteten Tabellen. | +| **Aufmerksamkeit nötig** | Tabellen mit langsamen Abfragen, Zeitüberschreitungen, offenen Empfehlungen oder fehlgeschlagenen Aufgaben. Beginnen Sie hier. | +| **Indizierte Suche** | Tabellen, für die bereits eine Suchabdeckung konfiguriert ist. | +| **Nicht konfiguriert** | Tabellen ohne Suchabdeckung. | +| **Nicht verfügbar** | Tabellen, die derzeit keine indizierte Suche nutzen können. Die Zeile nennt den Grund. | -**Tiefenanalyse** öffnet den Analysearbeitsbereich mit dieser Tabelle bereits vorausgefüllt. +Das Suchfeld akzeptiert Namen oder IDs von Tabellen, Bases und Spaces. Sortiert wird nach **Meiste langsame Abfragen** oder **Tabellenname**. Das **Beobachtungsfenster** umfasst die letzte Stunde, 24 Stunden oder 7 Tage, und alle Beobachtungswerte der Liste folgen diesem Fenster. -Wenn der Analysator umfangreiche Teilzeichenfolgensuchen in einer Tabelle erkennt, erstellt er für die gesamte Tabelle eine **erzeugter-Text-GIN**-Empfehlung statt eines Indexes pro Feld. Eine solche Zeile bietet **Suchpfad erstellen** anstelle von **Tiefenanalyse**; **Index hinzufügen** wird nicht angezeigt. Die Empfehlung wird automatisch abgeschlossen, sobald die Tabelle über den Pfad verfügt. +Jede Zeile nennt geschätzte Zeilenzahl und Größe der Tabelle, Anfragen und langsame Abfragen im Fenster, die aktuelle Suchmethode samt Feldabdeckung, die Anzahl der Filter-/Sortierindizes sowie offene Empfehlungen und aktive Aufgaben. Ein Klick auf den Tabellennamen öffnet die Detailansicht. -**Suchpfad erstellen** führt einen Probelauf (Dry Run) für die Tabelle direkt in einem Dialog auf dieser Seite aus. Der Dialog zeigt den Indexanbieter des Kandidaten, die Anzahl abgedeckter Felder, die geschätzten Zeilen sowie die `EXPLAIN`-Kosten vor und nach der Änderung. Geben Sie einen Beispielsuchbegriff ein, der mindestens so lang ist wie die angezeigte Mindestlänge; er dient nur der Prüfung und wird nicht gespeichert. Bei einer großen Tabelle bestätigen Sie zusätzlich das Kontrollkästchen für das Wartungsfenster. Nach der Bestätigung wird der Kandidat erneut geprüft und der Suchpfad aktiviert. +## Suchabdeckung konfigurieren -Liefert die Analyse keinen Kandidaten, nennt der Dialog den Grund und ändert nichts. Eine breite Tabelle wird abgelehnt, weil Teable dafür kein Suchdokument über alle Felder aufbaut; ein längerer Suchbegriff ändert daran nichts. Nutzen Sie dann **Ausgewählte Felder analysieren**, um im Analysearbeitsbereich nur die Felder zu analysieren, in denen Nutzer tatsächlich suchen. +Der Tab **Suchabdeckung** zeigt die aktuelle Suchmethode der Tabelle, die Anzahl der abgedeckten Felder und den Abdeckungsstatus jedes Felds. **Nicht abgedeckte Felder anzeigen** beschränkt die Liste auf die noch nicht einbezogenen Felder; Felder mit der Kennzeichnung **Nicht geeignet** können nicht zu einem Substring-Suchindex beitragen. -Daneben befinden sich zwei weitere Tabs: - -| Tab | Inhalt | -| --- | --- | -| **Häufig genutzte Tabellen** | Die am stärksten genutzten Tabellen mit Anfragen, langsamen Abfragen, Zeitüberschreitungen und längster Abfragedauer. | -| **Aufgaben** | Von Teable erstellte Behebungsaufgaben mit Status, Versuchen, Worker und dem letzten Fehler. | +Die Abdeckung wird ausdrücklich festgelegt. Später hinzugefügte Felder kommen nicht automatisch hinzu, konfigurieren Sie die Tabelle erneut, um sie aufzunehmen. Suchen außerhalb der Abdeckung oder mit zu kurzem Suchbegriff fallen auf einen langsameren `ILIKE`-Scan zurück. -Über der Liste wird ein Banner angezeigt, wenn ein Konfigurationsproblem den Vorgang aufhält: Suchzugriffspfade sind konfiguriert, während das Laufzeit-Flag deaktiviert ist; manche Tabellen haben einen veralteten oder zur Neuerstellung ausstehenden Zugriffspfad und ihre Suche ist unbemerkt auf den langsameren `ILIKE`-Scan zurückgefallen; oder die älteste in die Warteschlange gestellte Aufgabe wartet lange genug, um darauf hinzuweisen, dass kein Worker sie verarbeitet. Beheben Sie die im Banner gemeldeten Probleme, bevor Sie die darunterstehenden Empfehlungen bearbeiten. +Wählen Sie **Suche konfigurieren** bei einer noch nicht konfigurierten Tabelle oder **Auswahl aktualisieren / neu aufbauen** bei einer bereits konfigurierten. Der Dialog fragt Folgendes ab: -### Das Entscheidungs-Badge lesen +| Angabe | Was Sie eintragen | +| --- | --- | +| **Suchanbieter** | `pg_bigm` oder `pg_trgm`. Fehlt die Erweiterung, nennt der Dialog, was fehlt und wer es bereitstellen kann. | +| **Repräsentativer Suchtext** | Text, nach dem Ihre Benutzer tatsächlich suchen würden. Er prüft die Substring-Semantik und sammelt Nachweise aus dem Ausführungsplan und wird nie gespeichert. Ist er zu kurz, nennt der Dialog die Mindestlänge. | +| **Felder** | Wählen Sie die Felder aus, nach denen Benutzer wirklich suchen. Wählen Sie bei einer breiten Tabelle nicht alles aus, ein Suchdokument über alle Felder ist teuer. | -Jede Empfehlung trägt die letzte Systementscheidung dazu: +**Analysieren und Testlauf** führt die Änderung ohne Festschreibung aus und meldet die Anzahl abgedeckter Felder, die geschätzte Zeilenzahl, ob Nachweise aus dem Ausführungsplan vorliegen und welche Auswirkungen das Erstellen oder Neuaufbauen hat. Bei Tabellen mit geschätzt 50.000 Zeilen oder mehr sowie bei unbekannter Größe ist zusätzlich die Bestätigung des Wartungsfensters nötig. Anschließend wählen Sie **Bestätigen und Aufgabe einreihen**. -| Badge | Bedeutung | -| --- | --- | -| **Manuelle Bestätigung erforderlich** | Nur ein Administrator kann diese Empfehlung anwenden. | -| **Schattenmodus · würde automatisch ausgeführt** | Die Empfehlung erfüllt die Annahmekriterien, aber die automatische Ausführung ist nicht aktiviert; daher wurde nichts geändert. | -| **Wird automatisch ausgeführt** / **Automatisch ausgeführt** | Die automatische Ausführung hat die Empfehlung angenommen und angewendet. | -| **Nachprüfung fehlgeschlagen · Wartezeit wird erhöht** | Eine automatische Änderung hat die Überprüfung nicht bestanden. Teable wartet länger, bevor es diese Tabelle erneut versucht. | -| **Abkühlphase** | Derselbe Bereich wurde kürzlich geändert; daher wartet das System ab. | -| **Zurückgestellt** / **Automatische Ausführung nicht angewendet** | Die Plan-Nachweise oder die Tabellengröße erfüllten nicht die Voraussetzungen für die automatische Ausführung. | +Beim Erstellen oder Neuaufbauen der Suchabdeckung entstehen eine Suchspalte und ein GIN-Index. Dabei kann die gesamte Tabelle neu geschrieben werden, es werden Sperren gehalten, und die indizierte Suche ist kurzzeitig unterbrochen. Planen Sie den Vorgang in ein Wartungsfenster. -Standardmäßig zeichnet Teable nur Entscheidungen auf und erstellt Empfehlungs- und Aufgabenaufzeichnungen; es ändert Ihre Datenbank nicht selbstständig. Die automatische Ausführung ist über `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto` optional aktivierbar und gilt selbst dann nur für kleine Tabellen, deren Ausführungsplan eine eindeutige Kostenverbesserung zeigt. Alles andere wartet auf einen Administrator. +Der Dialog liefert eine Aufgabenbestätigung, kein Ergebnis. Schließen Sie ihn und verfolgen Sie die Aufgabe unter **Aufgaben / Verlauf**. Wird dieselbe Änderung erneut eingereicht, kommt die bestehende Aufgabe zurück. -### Den vorgeschlagenen Index hinzufügen +## Filter- und Sortierindizes verwalten -Wenn eine Empfehlung einen Index vorschlägt, dem Sie zustimmen, klicken Sie in der Zeile auf **Index hinzufügen**. Die Bestätigung nimmt die Empfehlung an und führt `CREATE INDEX CONCURRENTLY` in der zugrunde liegenden PostgreSQL-Tabelle aus; wenn die Planvalidierung übersprungen wurde, erstellt Teable den Index dennoch aus den empfohlenen Feldern. Der Dialog wiederholt die Nachweise, damit Sie sie ein letztes Mal prüfen können. +Der Tab **Filter- / Sortierindizes** listet die physischen Indizes auf, die Filterbedingungen und Sortierungen dieser Tabelle bedienen, jeweils mit Gültigkeit, Angabe zur Verwaltung durch Teable, Größe und Definition. Sie werden getrennt von den Substring-Suchindizes verwaltet. -Bei einer Tabelle mit geschätzten 50.000 Zeilen oder mehr fordert der Dialog Sie auf zu bestätigen, dass ein Wartungsfenster eingerichtet ist, bevor die Schaltfläche verfügbar wird. Eine parallele Erstellung für eine große Tabelle benötigt Zeit und verursacht während der Ausführung zusätzliche Last. +Darunter enthalten die **Ausstehenden Aktionen** die Indexempfehlungen des Systems und geben an, ob Nachweise aus dem Ausführungsplan dafür vorliegen. **Indexerstellung prüfen** zeigt den vorgeschlagenen Index, die ausführende Datenbank und die Nachweise; nach Ihrer Bestätigung führt Teable `CREATE INDEX CONCURRENTLY` asynchron aus. Für große Tabellen und Tabellen unbekannter Größe ist auch hier die Bestätigung des Wartungsfensters nötig. -Teable meldet anschließend entweder **Index erstellt** oder **Empfehlung angenommen und eingereiht**. Im zweiten Fall verfolgen Sie die Aufgabe unter **Aufgaben**. Wenn die Empfehlung keine ausführbare physische Spalte enthält, bleibt **Index hinzufügen** deaktiviert und weist darauf hin; verwenden Sie stattdessen den Analysearbeitsbereich zur weiteren Untersuchung. +Diese Seite löscht keine Indizes. Nicht verwaltete und System-Indizes können Constraints schützen oder andere Abfragen bedienen und bleiben deshalb unangetastet. -## Eine Tiefenanalyse ausführen +## Einzelne Abfragen diagnostizieren -Öffnen Sie den **Analysearbeitsbereich**, um einen Bereich bei Bedarf zu analysieren, beispielsweise wenn ein Nutzer eine langsame Tabelle meldet, für die noch keine Empfehlung vorliegt. +Wenn eine Tabelle als langsam gemeldet wird und keine Empfehlung dazu vorliegt, öffnen Sie den Tab **Abfragediagnose** und wählen **Abfragen analysieren**. Die Analyse liest nur gespeicherte Abfrageformen und vorhandene Nachweise aus dem Ausführungsplan und erstellt nichts. -| Analysetyp | Verwenden für | -| --- | --- | -| **Abfragen und Indizes** | Abfragerisiken und mögliche Indexverbesserungen finden. | -| **Teilzeichenfolgensuche** | Prüfen, ob ein Suchzugriffspfad für Teilzeichenfolgen Enthält-Suchen beschleunigen kann, ohne deren Übereinstimmungsverhalten zu ändern. | +Das Ergebnis lautet **Durch Ausführungsplan gestützte Indexchancen gefunden**, **Keine durch die vorliegenden Pläne bestätigte Indexchance** oder **Unzureichende Nachweise**. Unzureichende Nachweise bedeuten nicht, dass ein sequenzieller Scan stattgefunden hat: Eine langsame Beobachtung allein belegt nicht, dass der Zugriffspfad die Ursache ist. Darunter steht jede betroffene Abfrage mit der Angabe, ob sie aus echtem Verkehr oder einer gespeicherten Ansichtskonfiguration stammt, sowie die geschätzten Plankosten vor und nach dem vorgeschlagenen Index (Plankosten, keine Millisekunden). -Wählen Sie **Tabelle**, **Base** oder **Space**, geben Sie die entsprechende ID ein und wählen Sie einen Analysetyp. Beginnen Sie mit **Tabelle**, wenn Sie bereits wissen, welche Tabelle langsam ist. +## Ergebnisse verfolgen -Klicken Sie auf **Abfragebericht erstellen** oder **Suchbericht erstellen**. Der Bericht fasst erkannte Risiken und empfohlene nächste Schritte zusammen. Für einen Suchbericht ist **EXPLAIN-Beispielsuche** optional. Fügen Sie ein Beispiel hinzu, um Ergebnis-Kompatibilität, Abfragepläne und wiederholte Abfragezeiten für den vorgeschlagenen Suchzugriffspfad für Teilzeichenfolgen zu prüfen. Teable speichert den Beispielwert nicht. +Der Tab **Aufgaben / Verlauf** besteht aus drei Teilen: -Der Abfragebericht ändert die Datenbank nicht. Das Anwenden einer Empfehlung für die Teilzeichenfolgensuche erfordert eine **EXPLAIN-Beispielsuche** und die Bestätigung durch einen Administrator. +- **Aufgaben**: Hintergrundaufgaben dieser Tabelle mit Status, Anzahl der Versuche, Aufgabentyp und Fehlergrund. War eine Aufgabe nach einem Fehlschlag am Ende erfolgreich, ist der Fehler als früherer Versuch gekennzeichnet. +- **Verlauf der Suchkonfiguration**: Anbieter, Status und Feldliste jeder früheren Abdeckungskonfiguration. +- **Empfehlungsverlauf**: angenommene, verworfene oder ersetzte Empfehlungen. -Prüfen Sie bei einer großen Tabelle die Auswirkungen und planen Sie jede bestätigte Änderung für ein geeignetes Wartungsfenster ein. +Der Verlauf lädt nur die neuesten Einträge. Gibt es mehr, nennt eine Zeile über der Liste die Gesamtzahl. +Solange für eine Tabelle eine Aufgabe eingereiht ist oder läuft, bleiben die Schaltflächen zum Konfigurieren der Suche und zum Erstellen von Indizes deaktiviert. Warten Sie das Ende der Aufgabe ab. diff --git a/de/basic/credential.mdx b/de/basic/credential.mdx index c74574f9..2b0d17a2 100644 --- a/de/basic/credential.mdx +++ b/de/basic/credential.mdx @@ -26,7 +26,7 @@ Klicken Sie unten links auf Ihr Profilbild und öffnen Sie **Einstellungen** → Eine Verbindung fügen Sie über **Neues Konto verbinden** hinzu. Läuft eine Autorisierung ab, bietet die Verbindung **Neu verbinden** an. -Bei jedem Eintrag steht, wie viele Ressourcen ihn derzeit verwenden. **Anzeigen** öffnet die Liste der Apps und Automatisierungen, in der Sie für einzelne Einträge die **Freigabe entfernen** können. +Bei jedem Eintrag steht, wie viele Ressourcen ihn derzeit verwenden. **Anzeigen** öffnet die Liste der Apps und Automatisierungen, jeweils mit dem Zeitpunkt der Freigabe, in der Sie für einzelne Einträge die **Freigabe entfernen** können. ## Zugangsdaten für eine App oder Automatisierung freigeben diff --git a/de/basic/field/common/show-as.mdx b/de/basic/field/common/show-as.mdx index aaa0d7e2..e39a6c2c 100644 --- a/de/basic/field/common/show-as.mdx +++ b/de/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "Interaktive Anzeige" -description: "Ändern Sie die Darstellung und das Klickverhalten von Feldwerten, beispielsweise für URLs, E-Mails, Telefonnummern und Zahlendiagramme." +description: "Ändern Sie die Darstellung und das Klickverhalten von Feldwerten, beispielsweise für E-Mails, Telefonnummern und Zahlendiagramme." --- Die interaktive Anzeige ändert, wie Feldwerte dargestellt werden und wie sie sich beim Anklicken verhalten. Der Feldtyp wird dadurch nicht geändert. Es ändert sich lediglich, wie Benutzer die Feldinhalte anzeigen und mit ihnen interagieren. @@ -9,7 +9,6 @@ Die interaktive Anzeige ändert, wie Feldwerte dargestellt werden und wie sie si | Anzeige | Beschreibung | | --- | --- | -| URL | Zeigt Text als Webadresse an. Durch Anklicken wird der Link in einem Browser geöffnet | | E-Mail | Zeigt Text als E-Mail-Adresse an. Durch Anklicken wird die Standard-Mail-App geöffnet | | Telefon | Zeigt Text als Telefonnummer an. Durch Anklicken wird abhängig von der Geräteunterstützung eine Anrufaktion gestartet | diff --git a/de/basic/field/long-text.mdx b/de/basic/field/long-text.mdx index e983cf3e..ed24671b 100644 --- a/de/basic/field/long-text.mdx +++ b/de/basic/field/long-text.mdx @@ -46,5 +46,5 @@ description: "Speichern Sie langen Text mit Zeilenumbrüchen und zeigen Sie ihn ## Hinweise -- „Langtext“ unterstützt keine interaktive Anzeige für URL, E-Mail oder Telefon. Unterstützt werden nur Nur-Text und Markdown. -- Wenn der Inhalt keine Zeilenumbrüche benötigt und als URL, E-Mail oder Telefon angezeigt werden soll, verwenden Sie ein Feld vom Typ **Einzeiliger Text**. +- Webadressen im Text werden automatisch zu anklickbaren Links, ohne dass Sie etwas einstellen müssen. Im geöffneten Datensatz listet eine Schaltfläche neben dem Eingabefeld alle Adressen der Zelle auf. +- „Langtext“ unterstützt keine interaktive Anzeige für E-Mail oder Telefon. Verwenden Sie ein Feld vom Typ **Einzeiliger Text**, wenn eine Adresse oder Nummer zum Schreiben oder Anrufen anklickbar sein soll. diff --git a/de/basic/field/single-line-text.mdx b/de/basic/field/single-line-text.mdx index abee0d8d..c9c325d0 100644 --- a/de/basic/field/single-line-text.mdx +++ b/de/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ Für Notizen, Zusammenfassungen oder Beschreibungen, die Zeilenumbrüche benöti +## Automatische Linkerkennung + +Webadressen in einer Zelle werden automatisch zu anklickbaren Links, ohne dass Sie etwas einstellen müssen. Erkannt werden Adressen, die mit `https://` oder `www.` beginnen, sowie gängige Domains wie `teable.ai`. Enthält ein Wert mehrere Adressen, wird jede einzeln verlinkt. Im geöffneten Datensatz listet eine Schaltfläche neben dem Eingabefeld alle Adressen der Zelle auf. + +Dateinamen und Versionsnummern wie `readme.md` oder `v1.2.3` werden nicht als Adresse gewertet. + ## Anzeigemodus -„Einzeiliger Text“ unterstützt vier Anzeigemodi: +„Einzeiliger Text“ unterstützt drei Anzeigemodi: | Anzeigemodus | Geeignet für | Verhalten beim Klicken | | --- | --- | --- | -| Standard | Namen, Titel, IDs und sonstiger Nur-Text | Keine zusätzliche Aktion beim Klicken | -| URL | Webadressen | Öffnet die URL im Standardbrowser | +| Standard | Namen, Titel, IDs und sonstiger Nur-Text | Adressen werden zu Links und öffnen sich beim Anklicken | | E-Mail | E-Mail-Adressen | Öffnet die Standard-E-Mail-App | | Telefon | Telefonnummern | Öffnet die Kommunikations-App auf dem Gerät. Auf Mobilgeräten können Benutzer die Nummer direkt anrufen | @@ -45,7 +50,7 @@ Der Anzeigemodus ändert, wie der Wert dargestellt wird und sich beim Anklicken ## Häufige Verwendungszwecke -- **Kundenkontakte verwalten**: Erstellen Sie ein Feld „Unternehmenswebsite“ und legen Sie den Modus auf **URL** fest, damit die Website beim Anklicken geöffnet wird. Erstellen Sie ein Feld „Telefon“ und legen Sie den Modus auf **Telefon** fest, damit Benutzer auf Mobilgeräten mit einmaligem Tippen anrufen können. +- **Kundenkontakte verwalten**: Erstellen Sie ein Feld „Unternehmenswebsite“ und tragen Sie die Adresse ein, damit die Website beim Anklicken geöffnet wird. Erstellen Sie ein Feld „Telefon“ und legen Sie den Modus auf **Telefon** fest, damit Benutzer auf Mobilgeräten mit einmaligem Tippen anrufen können. - **Bestellungen oder Verträge verwalten**: Erstellen Sie ein Feld „Bestell-ID“ oder „Vertrags-ID“ für die Suche, Filterung und den Abgleich mit externen Systemen. - **Anfänglicher Ticketstatus**: Erstellen Sie ein Feld „Aktuelle Phase“ und legen Sie den Standardwert auf „Neu“ fest. Wenn die Phase aus einem festen Workflow stammt, verwenden Sie stattdessen ein Feld vom Typ **Einfachauswahl**. - **Text extrahieren und verketten**: Verweisen Sie in Formeln auf „Einzeiliger Text“, um ID-Segmente zu extrahieren, Anzeigenamen zu verketten oder das Textformat zu vereinheitlichen. @@ -53,5 +58,5 @@ Der Anzeigemodus ändert, wie der Wert dargestellt wird und sich beim Anklicken ## Hinweise - „Einzeiliger Text“ ist für kurze Inhalte vorgesehen. Die Eingabetaste bestätigt normalerweise die Eingabe. Verwenden Sie **Langtext** für Notizen, Artikelzusammenfassungen und andere lange Inhalte. -- URL, E-Mail und Telefon sind Anzeigemodi. Das Feld bleibt vom Typ „Einzeiliger Text“ und kann weiterhin sortiert, gefiltert und mit Textfunktionen verarbeitet werden. +- E-Mail und Telefon sind Anzeigemodi. Das Feld bleibt vom Typ „Einzeiliger Text“ und kann weiterhin sortiert, gefiltert und mit Textfunktionen verarbeitet werden. - „Einzeiliger Text“ beschränkt Werte nicht auf vordefinierte Optionen. Verwenden Sie **Einfachauswahl** oder **Mehrfachauswahl** für Statuswerte, Kategorien und Prioritäten, die einheitliche Werte benötigen. diff --git a/en/basic/admin-panel/computed-outbox.mdx b/en/basic/admin-panel/computed-outbox.mdx index 08f9b67a..c92472e5 100644 --- a/en/basic/admin-panel/computed-outbox.mdx +++ b/en/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ When a computed value looks wrong or arrived late, open **Computed lineage** to | Section | What it answers | | --- | --- | | Summary | End-to-end latency, when the source changed, when the value converged, and which table and fields triggered the run. A **Computing** badge means the chain is still running. | -| **Timeline** | When the run was enqueued, started, and completed or failed. | -| **Task chain** | Every task in the cascade, nested under the task that enqueued it, so you can see where a branch came from. Each row shows its state, plan steps, **Write target** (the table and fields that task updates), **Dirty rows**, cascade depth, enqueue time, and duration. | +| **Timeline** | Three lanes side by side: **End-to-end** runs from the source change to the computed writes settling, **This task** covers claim to commit, and **Wakeup job** is the wakeup that ran it. The task lane is split into queue wait, claim / setup, and compute. The wakeup job also drains other due work on the same database, so it normally outlasts end-to-end. | +| **Task chain** | Every task in the cascade, nested under the task that enqueued it, so you can see where a branch came from. Partial batches split off the same stage are a serial queue and stay flat at one level instead of nesting deeper. Each row shows its state, plan steps, **Write target** (the table and fields that task updates), **Estimated complexity**, cascade depth, enqueue time, and duration. | | **Field propagation** | Which fields the run read and wrote, and how the change traveled between them. Dashed blue is the origin that led to this write, gray is an input that was not written this run, green is written this run, and the arrows are field dependencies or link hops rather than step order. Only origins that actually reach this run's writes are drawn. Use **Expand** to open the graph full screen when a wide chain is hard to follow inline. | The lineage ledger only records tasks created after this feature shipped and keeps 7 days of history. An older task shows its queue facts without a propagation graph. A seed task the worker has not planned yet shows only its trigger fields. When a change produced no downstream computed writes, the graph says so: nothing depended on those fields through a formula, lookup, rollup, or link title. diff --git a/en/basic/admin-panel/overview.mdx b/en/basic/admin-panel/overview.mdx index be95152c..0c57cd35 100644 --- a/en/basic/admin-panel/overview.mdx +++ b/en/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ The Admin Panel groups its pages by purpose: ### Operations & audit - **[Automation management](/en/basic/admin-panel/automation-management)**: View automation run status and run history -- **[Table Query Ops](/en/basic/admin-panel/table-query-ops)**: Analyze table query risk and index recommendations +- **[Table Query Ops](/en/basic/admin-panel/table-query-ops)**: Configure search coverage per table, create indexes, and follow the results - **[Computed Outbox](/en/basic/admin-panel/computed-outbox)**: Monitor computed task delivery, queue health, and database backlog - **[AI generation queue](/en/basic/admin-panel/ai-generation-queue)**: Review AI field generation status in the current self-hosted instance - **[Sandbox Agent](/en/basic/admin-panel/sandbox-agent)**: Configure and manage Sandbox Agent diff --git a/en/basic/admin-panel/table-query-ops.mdx b/en/basic/admin-panel/table-query-ops.mdx index 6031abb9..df16f4d2 100644 --- a/en/basic/admin-panel/table-query-ops.mdx +++ b/en/basic/admin-panel/table-query-ops.mdx @@ -1,85 +1,74 @@ --- title: "Table Query Ops" -description: "Review query risk recommendations for slow tables and confirm database improvements." +description: "Review search coverage and indexes table by table, configure search, create indexes, and follow the results." --- Available for self-hosted Business plan and above Path: Admin Panel → Table Query Ops -Use **Table Query Ops** when views, filters, relations, or searches on a large table become slow. A background analyzer watches the query workload and turns what it observes into recommendations. The page lists them so instance administrators can review the evidence, analyze a specific table in more depth, and confirm any database change. +Use **Table search and indexes** when views, filters, relations, or searches on a large table become slow. Teable watches the query workload in the background and summarizes each table: how it is searched today, which fields are covered, which physical indexes exist, and how many slow queries it saw recently. Instance administrators configure search coverage, create indexes, and follow the results here. -The counters above the list summarize the current picture: observation windows, requests, slow queries, timeouts, open and accepted recommendations, running and failed tasks, and how many search access paths are ready or degraded. +The page only queues tasks; it never changes the database directly. Every change runs asynchronously in the background, so confirm the outcome under **Tasks / history**. -## Review Recommendations +## Find the table to work on -The page opens on **Recommendations**, ordered by priority. The analyzer weighs the risk of a query against how heavily the table is used, so the entries most worth acting on come first. +The page opens on the table list. The state buttons across the top carry their own counts and narrow the list: -Search by table, Base, or Space ID to filter across all recommendations; any other text filters what is already on screen. The status and risk filters narrow the list further. - -Each entry names the space, base, and table it belongs to. Expand a row to read the evidence behind the recommendation, the system decision, and the SQL diagnostics: - -| Section | What it tells you | +| State | Meaning | | --- | --- | -| **Trigger** | Where the recommendation came from: observed query traffic, a saved view configuration, or a relation field configuration. A saved-view trigger means no slow query was observed yet; the configuration alone is what raised the risk. | -| **Access path** | How often this table was reached by sequential scan versus index scan. | -| **Reasons** | Readable causes such as a large table, no useful index on the filter or sort fields, expensive sorting, or observed timeouts. | -| **Query shape** | The specific fields being filtered and sorted, with the kind of match each one uses. | -| **Proposed index** | The fields the recommendation would index, and why. | +| **All tables** | Every observed table. | +| **Needs attention** | Tables with slow queries, timeouts, pending recommendations, or failed tasks. Start here. | +| **Indexed search** | Tables that already have search coverage configured. | +| **Unconfigured** | Tables with no search coverage yet. | +| **Unavailable** | Tables that cannot use indexed search right now. The row states why. | -**Deep analysis** opens the analysis workspace with that table already filled in. +The search box accepts table, Base, and Space names or IDs. Sorting is either **Most slow queries** or **Table name**. **Observation window** covers the last 1 hour, 24 hours, or 7 days, and every observation figure in the list follows that window. -When the analyzer sees heavy substring searching across a table, it raises one **generated-text GIN** recommendation for that whole table instead of a per-field index. Such a row offers **Create search path** in place of **Deep analysis**, and **Add index** does not appear. The recommendation closes on its own once the table has the path. +Each row gives the table's estimated rows and size, the requests and slow queries within the window, the current search method and field coverage, the number of filter/sort indexes, and the counts of pending recommendations and active tasks. Click a table name to open its detail. -**Create search path** opens a dialog that runs a dry-run analysis of the table right there, without leaving the page. The dialog shows the candidate's index provider, covered field count, estimated rows, and the `EXPLAIN` cost before and after. Enter a sample search term long enough for the minimum probe length it reports; the term is only used to validate the path and is not stored. On a large table, confirm the maintenance-window checkbox as well. Confirming validates the candidate once more and then enables the search path. +## Configure search coverage -If the analysis returns no candidate, the dialog says why instead of enabling anything. A wide table is refused because Teable will not build an all-field search document for it, and a longer search term does not change that. Use **Analyze selected fields** to move to the analysis workspace and analyze only the fields users actually search. +The **Search coverage** tab shows the table's current search method, how many fields are covered, and the coverage state of each field. **Show uncovered fields** narrows the list to the fields not yet included; fields marked **Not eligible** cannot contribute to a substring search index. -Two more tabs sit beside it: +Coverage is explicit. Fields you add later are not included automatically; configure the table again to bring them in. Searches outside the coverage, or with a probe that is too short, fall back to a slower `ILIKE` scan. -| Tab | What it shows | -| --- | --- | -| **Hot tables** | The busiest tables, with requests, slow queries, timeouts, and longest query duration. | -| **Tasks** | Remediation tasks Teable created, with status, attempts, worker, and the last error. | +Choose **Configure search** on a table that has never been configured, or **Update selection / rebuild** on one that has. The dialog asks for: -A banner appears above the list when a configuration problem is holding the process up: search access paths are configured while the runtime flag is off, some tables have a stale or rebuild-pending access path and their search has silently fallen back to the slower `ILIKE` scan, or the oldest queued task has waited long enough to suggest no worker is consuming it. Fix what the banner reports before acting on the recommendations below it. +| Item | What to enter | +| --- | --- | +| **Search provider** | `pg_bigm` or `pg_trgm`. If the extension is missing, the dialog says what is missing and who can provision it. | +| **Representative search text** | Text your users would really search for. It checks substring semantics and collects plan evidence, and is never saved. If it is too short, the dialog names the minimum length. | +| **Fields** | Select the fields users actually search. Do not select everything on a wide table; building a search document for every field is expensive. | -### Read the Decision Badge +**Analyze and dry-run** runs the change without committing it and reports the covered field count, estimated rows, whether plan evidence exists, and the impact of creating or rebuilding. Tables estimated at 50,000 rows or more, or of unknown size, also require the maintenance-window acknowledgement. Then choose **Confirm and queue task**. -Each recommendation carries the latest decision the system made about it: +Creating or rebuilding search coverage generates a search column and a GIN index. It can rewrite the whole table and hold locks, and indexed search is briefly interrupted while it runs. Schedule it inside a maintenance window. -| Badge | Meaning | -| --- | --- | -| **Needs manual confirmation** | Only an administrator can apply this one. | -| **Shadow · would auto-run** | The recommendation meets the acceptance criteria, but automatic execution is not enabled, so nothing changed. | -| **Auto-executing** / **Auto-executed** | Automatic execution accepted the recommendation and applied it. | -| **Post-verify failed · backing off** | An automatic change did not pass verification. Teable waits longer before trying that table again. | -| **Cooling down** | The same scope was changed recently, so the system is holding off. | -| **On hold** / **Auto-execution not applied** | The plan evidence or the table size did not meet the bar for automatic execution. | +What the dialog returns is a task receipt, not a result. Close it and follow the task under **Tasks / history**. Submitting the same change again returns the existing task. -By default Teable only records decisions and creates recommendation and task records; it does not change your database on its own. Automatic execution is opt-in through `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`, and even then it applies only to small tables whose execution plan shows a clear cost improvement. Everything else waits for an administrator. +## Manage filter and sort indexes -### Add the Proposed Index +The **Filter / sort indexes** tab lists the physical indexes that serve filter predicates and ordering on this table, each with its validity, whether Teable manages it, its size, and its definition. These are managed separately from substring search indexes. -When a recommendation proposes an index you agree with, click **Add index** on the row. Confirming accepts the recommendation and runs `CREATE INDEX CONCURRENTLY` on the underlying PostgreSQL table; if plan validation was skipped, Teable still builds the index from the recommended fields. The dialog repeats the evidence so you can check it one last time. +**Pending actions** below holds the system's index recommendations and says whether plan evidence backs each one. **Review index creation** shows the proposed index, the database it runs against, and the evidence; after you confirm, Teable runs `CREATE INDEX CONCURRENTLY` asynchronously. Large tables and tables of unknown size need the maintenance-window acknowledgement here too. -For a table estimated at 50,000 rows or more, the dialog asks you to confirm that a maintenance window is in place before the button becomes available. A concurrent build on a large table takes time and adds load while it runs. +This page does not delete indexes. Unmanaged and system indexes may protect constraints or serve other workloads, so they are left alone. -Teable then reports either **Index created** or **Recommendation accepted and queued**. In the second case, follow the task under **Tasks**. If the recommendation has no executable physical column behind it, **Add index** stays disabled and says so; use the analysis workspace to look further instead. +## Diagnose specific queries -## Run a Deep Analysis +When someone reports a slow table and no recommendation covers it, open the **Query diagnosis** tab and choose **Analyze queries**. The analysis only reads saved query shapes and available plan evidence; it creates nothing. -Open **Analysis workspace** to analyze a scope on demand, for example when a user reports a slow table that has no recommendation yet. +The conclusion is one of **Plan-backed index opportunities found**, **No index opportunity confirmed by the available plans**, or **Insufficient evidence**. Insufficient evidence does not mean a sequential scan happened: a slow observation alone does not establish that the access path is at fault. Below it, each affected query is listed with whether it came from real traffic or a saved view configuration, and the estimated plan cost before and after the proposed index (plan cost, not milliseconds). -| Analysis type | Use it for | -| --- | --- | -| **Queries & indexes** | Find query risks and possible index improvements. | -| **Substring search** | Check whether a substring search access path could speed up contains searches without changing their matching behavior. | +## Follow the results -Choose **Table**, **Base**, or **Space**, enter the corresponding ID, and select an analysis type. Start with **Table** when you already know which table is slow. +The **Tasks / history** tab holds three parts: -Click **Generate query report** or **Generate search report**. The report summarizes detected risks and recommended next actions. For a search report, **EXPLAIN sample search** is optional. Add a sample to check result compatibility, query plans, and repeated query timing for the proposed substring search access path. Teable does not save the sample value. +- **Tasks**: background tasks for this table, with status, attempt count, task kind, and failure reason. When a task eventually succeeded after failing, the error is labelled as a prior attempt. +- **Search configuration history**: the provider, status, and field list of each past coverage configuration. +- **Recommendation history**: recommendations that were accepted, dismissed, or superseded. -The query report does not change the database. Applying a substring search recommendation requires an **EXPLAIN sample search** and administrator confirmation. +History loads only the most recent entries; when there are more, a line above the list gives the total. -For a large table, review the impact and schedule any confirmed change for a suitable maintenance window. +While a table has a queued or running task, the buttons for configuring search and creating indexes stay disabled. Wait for the task to finish. diff --git a/en/basic/credential.mdx b/en/basic/credential.mdx index 7eab2aaa..c6d8ab12 100644 --- a/en/basic/credential.mdx +++ b/en/basic/credential.mdx @@ -26,7 +26,7 @@ Click your avatar in the lower left, then open **Settings** → **Integrations** Add a connection with **Connect new account**. When an authorization expires, the connection offers **Reconnect**. -Each credential shows how many resources currently use it. Click **View** for the list of apps and automations, where you can **Remove grant** for any single one. +Each credential shows how many resources currently use it. Click **View** for the list of apps and automations, each marked with when the grant was made, where you can **Remove grant** for any single one. ## Grant a Credential to an App or Automation diff --git a/en/basic/field/common/show-as.mdx b/en/basic/field/common/show-as.mdx index 151af2a9..b4ce4724 100644 --- a/en/basic/field/common/show-as.mdx +++ b/en/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "Interactive Display" -description: "Change field value display and click behavior, such as URLs, emails, phone numbers, and number charts." +description: "Change field value display and click behavior, such as emails, phone numbers, and number charts." --- Interactive display changes how field values appear and behave when clicked. It does not change the field type. It only changes how users view and interact with the field content. @@ -9,7 +9,6 @@ Interactive display changes how field values appear and behave when clicked. It | Display | Description | | --- | --- | -| URL | Show text as a web address. Clicking it opens the link in a browser | | Email | Show text as an email address. Clicking it opens the default mail app | | Phone | Show text as a phone number. Clicking it starts a call action, depending on device support | diff --git a/en/basic/field/long-text.mdx b/en/basic/field/long-text.mdx index 7b57822e..67b0dbdc 100644 --- a/en/basic/field/long-text.mdx +++ b/en/basic/field/long-text.mdx @@ -46,5 +46,5 @@ description: "Store long text with line breaks, with support for plain text and ## Notes -- Long Text does not support URL, Email, or Phone interactive display. It only supports plain text and Markdown. -- If the content does not need line breaks and should use URL, Email, or Phone display, use a **Single Line Text** field. +- Web addresses in the text become clickable links automatically, with nothing to configure. In an expanded record, a link button next to the input lists every address found in the cell. +- Long Text does not support Email or Phone interactive display. Use a **Single Line Text** field when you need to click an address or number to write or call. diff --git a/en/basic/field/single-line-text.mdx b/en/basic/field/single-line-text.mdx index 49c75ad5..31fc8f23 100644 --- a/en/basic/field/single-line-text.mdx +++ b/en/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ For notes, summaries, or descriptions that need line breaks, use **[Long Text](/ +## Automatic Link Detection + +Web addresses in a cell become clickable links automatically, with nothing to configure. Teable recognizes addresses that start with `https://` or `www.`, as well as common domains such as `teable.ai`. When one value holds several addresses, each becomes its own link. In an expanded record, a link button next to the input lists every address found in the cell. + +File names and version numbers such as `readme.md` or `v1.2.3` are not mistaken for addresses. + ## Display Mode -Single Line Text supports four display modes: +Single Line Text supports three display modes: | Display mode | Good for | Click behavior | | --- | --- | --- | -| Default | Names, titles, IDs, and other plain text | No extra click behavior | -| URL | Web addresses | Opens the URL in the default browser | +| Default | Names, titles, IDs, and other plain text | Addresses become links and open when clicked | | Email | Email addresses | Opens the default email app | | Phone | Phone numbers | Opens the communication app on the device. On mobile, users can call the number directly | @@ -45,7 +50,7 @@ Display mode changes how the value appears and behaves when clicked. It does not ## Common Uses -- **Customer contact management**: Create a "Company Website" field and set it to **URL** so the website opens when clicked. Create a "Phone" field and set it to **Phone** so mobile users can call in one tap. +- **Customer contact management**: Create a "Company Website" field and type the address in it so the website opens when clicked. Create a "Phone" field and set it to **Phone** so mobile users can call in one tap. - **Order or contract management**: Create an "Order ID" or "Contract ID" field for search, filtering, and matching with external systems. - **Initial ticket status**: Create a "Current Stage" field and set the default value to "New". If the stage comes from a fixed workflow, use a **Single Select** field instead. - **Text extraction and concatenation**: Reference Single Line Text in formulas to extract ID segments, concatenate display names, or normalize text format. @@ -53,5 +58,5 @@ Display mode changes how the value appears and behaves when clicked. It does not ## Notes - Single Line Text is for short content. The Enter key usually confirms input. Use **Long Text** for notes, article summaries, and other long content. -- URL, Email, and Phone are display modes. The field remains Single Line Text and can still be sorted, filtered, and processed with text functions. +- Email and Phone are display modes. The field remains Single Line Text and can still be sorted, filtered, and processed with text functions. - Single Line Text does not limit values to predefined options. Use **Single Select** or **Multiple Select** for statuses, categories, and priorities that need consistent values. diff --git a/es/basic/admin-panel/computed-outbox.mdx b/es/basic/admin-panel/computed-outbox.mdx index ba8725b3..c8f95ee3 100644 --- a/es/basic/admin-panel/computed-outbox.mdx +++ b/es/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ Cuando un valor calculado parezca incorrecto o llegue con retraso, abre **Linaje | Sección | Qué responde | | --- | --- | | Resumen | La latencia de extremo a extremo, cuándo cambió el origen, cuándo convergió el valor y qué Tabla y Campos desencadenaron la ejecución. Un distintivo **Calculando** significa que la cadena sigue ejecutándose. | -| **Cronología** | Cuándo se añadió la ejecución a la cola, cuándo comenzó y cuándo se completó o falló. | -| **Cadena de tareas** | Todas las tareas de la cascada, anidadas bajo la tarea que las añadió a la cola, para que puedas ver el origen de cada rama. Cada fila muestra su estado, los pasos del plan, el **Destino de escritura** (la Tabla y los Campos que actualiza la tarea), las **Filas pendientes**, la profundidad de la cascada, la hora de entrada en la cola y la duración. | +| **Cronología** | Tres ejes en paralelo: **Extremo a extremo** va del cambio de origen hasta que convergen las escrituras calculadas, **Esta tarea** abarca del claim al commit, y **Job de despertar** es el despertar que la ejecutó. El eje de la tarea se divide en espera en cola, claim / setup y cálculo. El job de despertar también drena otro trabajo vencido de la misma base, así que normalmente dura más que el extremo a extremo. | +| **Cadena de tareas** | Todas las tareas de la cascada, anidadas bajo la tarea que las añadió a la cola, para que puedas ver el origen de cada rama. Los lotes parciales derivados de una misma etapa forman una cola serie y se mantienen al mismo nivel en lugar de anidarse más. Cada fila muestra su estado, los pasos del plan, el **Destino de escritura** (la Tabla y los Campos que actualiza la tarea), la **Complejidad estimada**, la profundidad de la cascada, la hora de entrada en la cola y la duración. | | **Propagación de Campos** | Qué Campos leyó y escribió la ejecución, y cómo se propagó el cambio entre ellos. La línea azul discontinua indica el origen que dio lugar a esta escritura; la gris, una entrada que no se escribió en esta ejecución; la verde, lo escrito en esta ejecución; y las flechas representan dependencias entre Campos o saltos de enlace, no el orden de los pasos. Solo se dibujan los orígenes que realmente alcanzan las escrituras de esta ejecución. Usa **Expandir** para abrir el gráfico a pantalla completa cuando resulte difícil seguir una cadena ancha en la vista integrada. | El libro mayor de linaje solo registra las tareas creadas desde la publicación de esta función y conserva un historial de 7 días. Las tareas anteriores muestran los datos de su cola sin un gráfico de propagación. Una tarea inicial que el proceso de trabajo aún no haya planificado muestra únicamente sus Campos desencadenantes. Cuando un cambio no produce escrituras calculadas posteriores, el gráfico lo indica: nada dependía de esos Campos mediante una fórmula, una búsqueda, una acumulación o el título de un enlace. diff --git a/es/basic/admin-panel/overview.mdx b/es/basic/admin-panel/overview.mdx index 658b9ad2..70d69bb9 100644 --- a/es/basic/admin-panel/overview.mdx +++ b/es/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ Administración del sistema agrupa sus páginas según su finalidad: ### Operaciones y auditoría - **[Gestión de automatizaciones](/es/basic/admin-panel/automation-management)**: Consulta el estado y el historial de las ejecuciones de automatizaciones -- **[Operaciones de consulta de Tablas](/es/basic/admin-panel/table-query-ops)**: Analiza los riesgos de las consultas de Tablas y las recomendaciones de índices +- **[Operaciones de consulta de Tablas](/es/basic/admin-panel/table-query-ops)**: Configura la cobertura de búsqueda por Tabla, crea índices y sigue los resultados - **[Bandeja de salida de cálculos](/es/basic/admin-panel/computed-outbox)**: Supervisa la entrega de tareas calculadas, el estado de la cola y la acumulación de trabajo de la base de datos - **[Cola de generación de IA](/es/basic/admin-panel/ai-generation-queue)**: Consulta el estado de generación de los Campos de IA en la instancia autoalojada actual - **[Agente de entorno aislado](/es/basic/admin-panel/sandbox-agent)**: Configura y administra el Agente de entorno aislado diff --git a/es/basic/admin-panel/table-query-ops.mdx b/es/basic/admin-panel/table-query-ops.mdx index 826e270f..7de012eb 100644 --- a/es/basic/admin-panel/table-query-ops.mdx +++ b/es/basic/admin-panel/table-query-ops.mdx @@ -1,85 +1,74 @@ --- title: "Operaciones de consulta de Tablas" -description: "Revisa las recomendaciones sobre riesgos de consulta en Tablas lentas y confirma las mejoras de la base de datos." +description: "Revisa la cobertura de búsqueda y los índices Tabla por Tabla, configura la búsqueda, crea índices y sigue los resultados." --- Disponible para el plan Business autoalojado y los planes superiores Ruta: Administración del sistema → Operaciones de consulta de Tablas -Usa **Operaciones de consulta de Tablas** cuando las Vistas, los filtros, las relaciones o las búsquedas de una Tabla grande se vuelvan lentos. Un analizador en segundo plano supervisa la carga de las consultas y convierte sus observaciones en recomendaciones. La página las enumera para que los administradores de la instancia puedan revisar las pruebas, analizar una Tabla concreta con más detalle y confirmar cualquier cambio en la base de datos. +Usa **Búsqueda e índices de Tablas** cuando las Vistas, los filtros, las relaciones o las búsquedas de una Tabla grande se vuelvan lentos. Teable observa la carga de consultas en segundo plano y resume cada Tabla: cómo se busca actualmente, qué Campos están cubiertos, qué índices físicos existen y cuántas consultas lentas se registraron hace poco. Los administradores de la instancia configuran aquí la cobertura de búsqueda, crean índices y siguen los resultados. -Los contadores situados sobre la lista resumen la situación actual: periodos de observación, solicitudes, consultas lentas, tiempos de espera agotados, recomendaciones abiertas y aceptadas, tareas en curso y fallidas, y cuántas rutas de acceso de búsqueda están listas o degradadas. +La página solo pone tareas en cola; nunca cambia la base de datos directamente. Cada cambio se ejecuta de forma asíncrona en segundo plano, así que confirma el resultado en **Tareas / historial**. -## Revisar recomendaciones +## Encontrar la Tabla que necesita atención -La página se abre en **Recomendaciones**, ordenadas por prioridad. El analizador pondera el riesgo de una consulta según la intensidad de uso de la Tabla, por lo que las entradas que más conviene atender aparecen primero. +La página se abre con la lista de Tablas. Los botones de estado de la parte superior llevan su propio recuento y acotan la lista: -Busca por ID de Tabla, Base o Espacio para filtrar todas las recomendaciones; cualquier otro texto filtra lo que ya aparece en pantalla. Los filtros de estado y riesgo permiten acotar aún más la lista. - -Cada entrada indica el Espacio, la Base y la Tabla a los que pertenece. Expande una fila para consultar las pruebas que respaldan la recomendación, la decisión del sistema y los diagnósticos SQL: - -| Sección | Qué indica | +| Estado | Significado | | --- | --- | -| **Desencadenador** | De dónde procede la recomendación: tráfico de consultas observado, la configuración de una Vista guardada o la configuración de un Campo de relación. Un desencadenador de Vista guardada significa que todavía no se ha observado ninguna consulta lenta; el riesgo se detectó únicamente a partir de la configuración. | -| **Ruta de acceso** | Con qué frecuencia se accedió a esta Tabla mediante un análisis secuencial frente a un análisis por índice. | -| **Motivos** | Causas comprensibles, como una Tabla grande, la ausencia de un índice útil en los Campos de filtro u ordenación, una ordenación costosa o tiempos de espera agotados observados. | -| **Patrón de consulta** | Los Campos concretos que se filtran y ordenan, junto con el tipo de coincidencia que usa cada uno. | -| **Índice propuesto** | Los Campos que indexaría la recomendación y el motivo. | +| **Todas las Tablas** | Todas las Tablas observadas. | +| **Requiere atención** | Tablas con consultas lentas, tiempos de espera agotados, recomendaciones pendientes o tareas fallidas. Empieza por aquí. | +| **Búsqueda indexada** | Tablas que ya tienen configurada la cobertura de búsqueda. | +| **Sin configurar** | Tablas sin cobertura de búsqueda. | +| **No disponible** | Tablas que ahora mismo no pueden usar la búsqueda indexada. La fila indica el motivo. | -**Análisis profundo** abre el Espacio de trabajo de análisis con esa Tabla ya introducida. +El cuadro de búsqueda admite nombres o identificadores de Tabla, Base y Espacio. La ordenación puede ser **Más consultas lentas** o **Nombre de Tabla**. La **Ventana de observación** abarca la última hora, 24 horas o 7 días, y todas las cifras de observación de la lista siguen esa ventana. -Cuando el analizador detecta un uso intensivo de búsquedas de subcadenas en una Tabla, genera una única recomendación de **GIN de texto generado** para toda la Tabla, en lugar de un índice por Campo. Esa fila ofrece **Crear ruta de búsqueda** en lugar de **Análisis profundo**, y **Añadir índice** no aparece. La recomendación se cierra automáticamente cuando la Tabla dispone de la ruta. +Cada fila muestra las filas y el tamaño estimados de la Tabla, las solicitudes y las consultas lentas de la ventana, el método de búsqueda actual y la cobertura de Campos, el número de índices de filtro/orden, y los recuentos de recomendaciones pendientes y tareas activas. Haz clic en el nombre de una Tabla para abrir su detalle. -**Crear ruta de búsqueda** abre un cuadro de diálogo que ejecuta un análisis de prueba (dry run) de la Tabla sin salir de la página. El cuadro muestra el proveedor de índice del candidato, cuántos Campos cubre, las filas estimadas y el coste de `EXPLAIN` antes y después. Escribe un término de búsqueda de ejemplo con al menos la longitud mínima indicada; solo sirve para validar y no se guarda. En una Tabla grande, marca además la casilla de la ventana de mantenimiento. Al confirmar, Teable vuelve a validar el candidato y activa la ruta de búsqueda. +## Configurar la cobertura de búsqueda -Si el análisis no devuelve ningún candidato, el cuadro explica el motivo y no ejecuta nada. Una Tabla ancha se rechaza porque Teable no crea para ella un documento de búsqueda con todos los Campos, y un término más largo no cambia eso. Usa **Analizar Campos seleccionados** para ir al Espacio de trabajo de análisis y analizar solo los Campos en los que la gente busca realmente. +La pestaña **Cobertura de búsqueda** muestra el método de búsqueda actual de la Tabla, cuántos Campos están cubiertos y el estado de cobertura de cada Campo. **Mostrar campos no cubiertos** limita la lista a los Campos aún no incluidos; los Campos marcados como **No apto** no pueden formar parte de un índice de búsqueda por subcadena. -Hay otras dos pestañas junto a ella: +La cobertura es explícita. Los Campos que añadas después no se incluyen de forma automática: vuelve a configurar la Tabla para incorporarlos. Las búsquedas fuera de la cobertura, o con un término demasiado corto, recurren a un escaneo `ILIKE` más lento. -| Pestaña | Qué muestra | -| --- | --- | -| **Tablas con más actividad** | Las Tablas con más actividad, junto con sus solicitudes, consultas lentas, tiempos de espera agotados y la duración de la consulta más larga. | -| **Tareas** | Las tareas de corrección creadas por Teable, con su estado, intentos, proceso de trabajo y último error. | +Elige **Configurar búsqueda** en una Tabla que nunca se haya configurado, o **Actualizar selección / reconstruir** en una que sí. El cuadro de diálogo pide: -Aparece un banner sobre la lista cuando un problema de configuración está bloqueando el proceso: hay rutas de acceso de búsqueda configuradas mientras el indicador del entorno de ejecución está desactivado; algunas Tablas tienen una ruta de acceso obsoleta o pendiente de reconstrucción y su búsqueda ha vuelto silenciosamente al análisis `ILIKE`, que es más lento; o la tarea más antigua de la cola lleva tanto tiempo esperando que parece que ningún proceso de trabajo la está consumiendo. Corrige el problema indicado en el banner antes de actuar sobre las recomendaciones que aparecen debajo. +| Elemento | Qué introducir | +| --- | --- | +| **Proveedor de búsqueda** | `pg_bigm` o `pg_trgm`. Si falta la extensión, el cuadro de diálogo indica qué falta y quién puede instalarla. | +| **Texto de búsqueda representativo** | Un texto que tus usuarios buscarían de verdad. Sirve para comprobar la semántica de subcadena y recoger pruebas del plan, y nunca se guarda. Si es demasiado corto, el cuadro de diálogo indica la longitud mínima. | +| **Campos** | Selecciona los Campos que los usuarios buscan realmente. No lo selecciones todo en una Tabla ancha: crear un documento de búsqueda para cada Campo sale caro. | -### Interpretar el distintivo de decisión +**Analizar y simular** ejecuta el cambio sin aplicarlo e informa del número de Campos cubiertos, las filas estimadas, si existen pruebas del plan y el impacto de crear o reconstruir. Las Tablas estimadas en 50.000 filas o más, y las de tamaño desconocido, requieren además marcar la confirmación de la ventana de mantenimiento. Después elige **Confirmar y poner la tarea en cola**. -Cada recomendación incluye la decisión más reciente que el sistema ha tomado al respecto: +Crear o reconstruir la cobertura de búsqueda genera una columna de búsqueda y un índice GIN. Puede reescribir toda la Tabla y mantener bloqueos, y la búsqueda indexada se interrumpe brevemente mientras se ejecuta. Prográmalo dentro de una ventana de mantenimiento. -| Distintivo | Significado | -| --- | --- | -| **Requiere confirmación manual** | Solo un administrador puede aplicar esta recomendación. | -| **Simulación · se ejecutaría automáticamente** | La recomendación cumple los criterios de aceptación, pero la ejecución automática no está habilitada, por lo que no se ha realizado ningún cambio. | -| **En ejecución automática** / **Ejecutada automáticamente** | La ejecución automática ha aceptado y aplicado la recomendación. | -| **Error en la verificación posterior · reintento aplazado** | Un cambio automático no superó la verificación. Teable espera más tiempo antes de volver a intentarlo en esa Tabla. | -| **En periodo de espera** | El mismo ámbito se ha modificado recientemente, por lo que el sistema está esperando. | -| **En espera** / **Ejecución automática no aplicada** | Las pruebas del plan o el tamaño de la Tabla no alcanzaron el umbral necesario para la ejecución automática. | +Lo que devuelve el cuadro de diálogo es un acuse de recibo de la tarea, no un resultado. Ciérralo y sigue la tarea en **Tareas / historial**. Si vuelves a enviar el mismo cambio, se devuelve la tarea existente. -De forma predeterminada, Teable solo registra las decisiones y crea registros de recomendaciones y tareas; no modifica la base de datos por sí solo. La ejecución automática se habilita de forma voluntaria mediante `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto` y, aun así, solo se aplica a Tablas pequeñas cuyo plan de ejecución muestra una mejora clara de costes. Todo lo demás queda pendiente de un administrador. +## Gestionar los índices de filtro y orden -### Añadir el índice propuesto +La pestaña **Índices de filtro / orden** enumera los índices físicos que sirven a las condiciones de filtro y a la ordenación de esta Tabla, cada uno con su validez, si lo gestiona Teable, su tamaño y su definición. Se gestionan por separado de los índices de búsqueda por subcadena. -Cuando estés de acuerdo con el índice propuesto por una recomendación, haz clic en **Añadir índice** en la fila. Al confirmar, se acepta la recomendación y se ejecuta `CREATE INDEX CONCURRENTLY` en la Tabla PostgreSQL subyacente; si se omitió la validación del plan, Teable crea igualmente el índice a partir de los Campos recomendados. El cuadro de diálogo repite las pruebas para que puedas comprobarlas una última vez. +Debajo, **Acciones pendientes** reúne las recomendaciones de índice del sistema e indica si hay pruebas del plan que las respalden. **Revisar creación de índice** muestra el índice propuesto, la base de datos en la que se ejecuta y las pruebas; tras tu confirmación, Teable ejecuta `CREATE INDEX CONCURRENTLY` de forma asíncrona. Las Tablas grandes y las de tamaño desconocido también requieren aquí la confirmación de la ventana de mantenimiento. -En las Tablas con una estimación de 50 000 filas o más, el cuadro de diálogo te pide que confirmes la existencia de una ventana de mantenimiento antes de habilitar el botón. La creación simultánea en una Tabla grande requiere tiempo y añade carga mientras se ejecuta. +Esta página no elimina índices. Los índices no gestionados y los del sistema pueden proteger restricciones o servir a otras cargas de trabajo, así que no se tocan. -Teable informa entonces de que el **Índice se ha creado** o de que la **Recomendación se ha aceptado y añadido a la cola**. En el segundo caso, sigue la tarea en **Tareas**. Si la recomendación no tiene ninguna columna física ejecutable asociada, **Añadir índice** permanece deshabilitado e indica el motivo; usa el Espacio de trabajo de análisis para investigar con más detalle. +## Diagnosticar consultas concretas -## Ejecutar un análisis profundo +Cuando alguien informa de una Tabla lenta y ninguna recomendación la cubre, abre la pestaña **Diagnóstico de consultas** y elige **Analizar consultas**. El análisis solo lee las formas de consulta guardadas y las pruebas de plan disponibles; no crea nada. -Abre el **Espacio de trabajo de análisis** para analizar un ámbito cuando lo necesites, por ejemplo, cuando un usuario informe de una Tabla lenta para la que aún no haya ninguna recomendación. +La conclusión es **Se encontraron oportunidades de índice respaldadas por el plan**, **Ningún plan disponible confirma una oportunidad de índice** o **Pruebas insuficientes**. Que las pruebas sean insuficientes no significa que se produjera un escaneo secuencial: una observación lenta por sí sola no demuestra que la ruta de acceso sea la causa. Debajo se enumera cada consulta afectada, si procede del tráfico real o de una configuración de Vista guardada, y el coste de plan estimado antes y después del índice propuesto (coste de plan, no milisegundos). -| Tipo de análisis | Para qué se utiliza | -| --- | --- | -| **Consultas e índices** | Detectar riesgos de consulta y posibles mejoras de índices. | -| **Búsqueda de subcadenas** | Comprobar si una ruta de acceso para búsquedas de subcadenas podría acelerar las búsquedas de contenido sin cambiar su comportamiento de coincidencia. | +## Seguir los resultados -Elige **Tabla**, **Base** o **Espacio**, introduce el ID correspondiente y selecciona un tipo de análisis. Empieza por **Tabla** cuando ya sepas qué Tabla es lenta. +La pestaña **Tareas / historial** tiene tres partes: -Haz clic en **Generar informe de consultas** o **Generar informe de búsqueda**. El informe resume los riesgos detectados y las siguientes acciones recomendadas. En los informes de búsqueda, la **Búsqueda de muestra con EXPLAIN** es opcional. Añade una muestra para comprobar la compatibilidad de los resultados, los planes de consulta y los tiempos de consultas repetidas de la ruta de acceso propuesta para búsquedas de subcadenas. Teable no guarda el valor de muestra. +- **Tareas**: las tareas en segundo plano de esta Tabla, con estado, número de intentos, tipo de tarea y motivo del fallo. Si una tarea acabó completándose tras fallar, el error se marca como intento anterior. +- **Historial de configuración de búsqueda**: el proveedor, el estado y la lista de Campos de cada configuración de cobertura anterior. +- **Historial de recomendaciones**: recomendaciones aceptadas, descartadas o sustituidas. -El informe de consultas no modifica la base de datos. Para aplicar una recomendación de búsqueda de subcadenas se necesita una **Búsqueda de muestra con EXPLAIN** y la confirmación de un administrador. +El historial solo carga las entradas más recientes. Si hay más, una línea sobre la lista indica el total. -En las Tablas grandes, revisa el impacto y programa cualquier cambio confirmado para una ventana de mantenimiento adecuada. +Mientras una Tabla tenga una tarea en cola o en ejecución, los botones para configurar la búsqueda y crear índices permanecen deshabilitados. Espera a que termine la tarea. diff --git a/es/basic/credential.mdx b/es/basic/credential.mdx index ecbf536c..76fb4c8d 100644 --- a/es/basic/credential.mdx +++ b/es/basic/credential.mdx @@ -26,7 +26,7 @@ Haz clic en tu avatar de la esquina inferior izquierda y abre **Ajustes** → ** Las conexiones se añaden con **Conectar nueva cuenta**. Cuando caduca una autorización, la conexión ofrece **Volver a conectar**. -Cada credencial indica cuántos recursos la usan ahora mismo. **Ver** abre la lista de aplicaciones y automatizaciones, donde puedes **Quitar autorización** a cualquiera de ellas. +Cada credencial indica cuántos recursos la usan ahora mismo. **Ver** abre la lista de aplicaciones y automatizaciones, cada una con la fecha en que se concedió la autorización, donde puedes **Quitar autorización** a cualquiera de ellas. ## Conceder una credencial a una aplicación o automatización diff --git a/es/basic/field/common/show-as.mdx b/es/basic/field/common/show-as.mdx index baf8910a..2d6a13d2 100644 --- a/es/basic/field/common/show-as.mdx +++ b/es/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "Visualización interactiva" -description: "Cambia la visualización y el comportamiento al hacer clic en los valores de los campos, como URL, correos electrónicos, números de teléfono y gráficos numéricos." +description: "Cambia la visualización y el comportamiento al hacer clic en los valores de los campos, como correos electrónicos, números de teléfono y gráficos numéricos." --- La visualización interactiva cambia la apariencia y el comportamiento de los valores de los campos al hacer clic en ellos. No cambia el tipo de campo, sino únicamente la forma en que los usuarios ven el contenido del campo e interactúan con él. @@ -9,7 +9,6 @@ La visualización interactiva cambia la apariencia y el comportamiento de los va | Visualización | Descripción | | --- | --- | -| URL | Muestra el texto como una dirección web. Al hacer clic, abre el enlace en un navegador | | Correo electrónico | Muestra el texto como una dirección de correo electrónico. Al hacer clic, abre la aplicación de correo predeterminada | | Teléfono | Muestra el texto como un número de teléfono. Al hacer clic, inicia una llamada, según la compatibilidad del dispositivo | diff --git a/es/basic/field/long-text.mdx b/es/basic/field/long-text.mdx index 24a4484a..6a70b81b 100644 --- a/es/basic/field/long-text.mdx +++ b/es/basic/field/long-text.mdx @@ -46,5 +46,5 @@ description: "Almacena texto extenso con saltos de línea y admite la visualizac ## Notas -- Texto largo no admite la visualización interactiva como URL, correo electrónico o teléfono. Solo admite texto sin formato y Markdown. -- Si el contenido no necesita saltos de línea y debe mostrarse como URL, correo electrónico o teléfono, usa un Campo **Texto de una línea**. +- Las direcciones web del texto se convierten en enlaces en los que se puede hacer clic, sin necesidad de configurar nada. Al abrir un Registro, un botón junto al campo de entrada muestra todas las direcciones encontradas en la celda. +- Texto largo no admite la visualización interactiva como correo electrónico o teléfono. Usa un Campo **Texto de una línea** cuando quieras hacer clic en una dirección o un número para escribir o llamar. diff --git a/es/basic/field/single-line-text.mdx b/es/basic/field/single-line-text.mdx index 690007cd..9df7438f 100644 --- a/es/basic/field/single-line-text.mdx +++ b/es/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ Para notas, resúmenes o descripciones que necesiten saltos de línea, usa **[Te +## Detección automática de enlaces + +Las direcciones web de una celda se convierten en enlaces en los que se puede hacer clic, sin necesidad de configurar nada. Se reconocen las direcciones que empiezan por `https://` o `www.`, además de dominios habituales como `teable.ai`. Si un valor contiene varias direcciones, cada una se convierte en un enlace independiente. Al abrir un Registro, un botón junto al campo de entrada muestra todas las direcciones encontradas en la celda. + +Los nombres de archivo y los números de versión como `readme.md` o `v1.2.3` no se confunden con direcciones. + ## Modo de visualización -Texto de una línea admite cuatro modos de visualización: +Texto de una línea admite tres modos de visualización: | Modo de visualización | Adecuado para | Comportamiento al hacer clic | | --- | --- | --- | -| Predeterminado | Nombres, títulos, identificadores y otro texto sin formato | Ningún comportamiento adicional al hacer clic | -| URL | Direcciones web | Abre la URL en el navegador predeterminado | +| Predeterminado | Nombres, títulos, identificadores y otro texto sin formato | Las direcciones se convierten en enlaces y se abren al hacer clic | | Correo electrónico | Direcciones de correo electrónico | Abre la aplicación de correo electrónico predeterminada | | Teléfono | Números de teléfono | Abre la aplicación de comunicación del dispositivo. En dispositivos móviles, los usuarios pueden llamar directamente al número | @@ -45,7 +50,7 @@ El modo de visualización cambia la apariencia y el comportamiento del valor al ## Usos habituales -- **Gestión de contactos de clientes**: crea un Campo "Sitio web de la empresa" y configúralo como **URL** para que el sitio se abra al hacer clic. Crea un Campo "Teléfono" y configúralo como **Teléfono** para que los usuarios de dispositivos móviles puedan llamar con un solo toque. +- **Gestión de contactos de clientes**: crea un Campo "Sitio web de la empresa" y escribe la dirección para que el sitio se abra al hacer clic. Crea un Campo "Teléfono" y configúralo como **Teléfono** para que los usuarios de dispositivos móviles puedan llamar con un solo toque. - **Gestión de pedidos o contratos**: crea un Campo "ID del pedido" o "ID del contrato" para realizar búsquedas, filtros y correspondencias con sistemas externos. - **Estado inicial de las incidencias**: crea un Campo "Etapa actual" y establece el valor predeterminado en "Nuevo". Si la etapa procede de un flujo de trabajo fijo, usa en su lugar un Campo **Selección única**. - **Extracción y concatenación de texto**: usa Texto de una línea como referencia en las fórmulas para extraer segmentos de identificadores, concatenar nombres para mostrar o normalizar el formato del texto. @@ -53,5 +58,5 @@ El modo de visualización cambia la apariencia y el comportamiento del valor al ## Notas - Texto de una línea está pensado para contenido breve. La tecla Intro suele confirmar la entrada. Usa **Texto largo** para notas, resúmenes de artículos y otros contenidos extensos. -- URL, Correo electrónico y Teléfono son modos de visualización. El Campo sigue siendo Texto de una línea y se puede continuar ordenando, filtrando y procesando con funciones de texto. +- Correo electrónico y Teléfono son modos de visualización. El Campo sigue siendo Texto de una línea y se puede continuar ordenando, filtrando y procesando con funciones de texto. - Texto de una línea no limita los valores a opciones predefinidas. Usa **Selección única** o **Selección múltiple** para estados, categorías y prioridades que necesiten valores coherentes. diff --git a/fr/basic/admin-panel/computed-outbox.mdx b/fr/basic/admin-panel/computed-outbox.mdx index 43883159..8f2780ad 100644 --- a/fr/basic/admin-panel/computed-outbox.mdx +++ b/fr/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ Lorsqu’une valeur calculée semble incorrecte ou est arrivée tardivement, ouv | Section | Ce qu’elle indique | | --- | --- | | Résumé | Latence de bout en bout, date de modification de la source, date de convergence de la valeur, ainsi que la table et les champs qui ont déclenché l’exécution. Un badge **En cours de calcul** signifie que la chaîne est toujours en cours d’exécution. | -| **Chronologie** | Date de mise en file d’attente, de début et de fin ou d’échec de l’exécution. | -| **Chaîne de tâches** | Toutes les tâches de la cascade, imbriquées sous la tâche qui les a mises en file d’attente, afin de voir l’origine de chaque branche. Chaque ligne indique son état, les étapes du plan, la **Cible d’écriture** (la table et les champs que cette tâche met à jour), les **Lignes modifiées**, la profondeur de cascade, l’heure de mise en file d’attente et la durée. | +| **Chronologie** | Trois axes côte à côte : **Bout-en-bout** va de la modification source à la convergence des écritures calculées, **Cette tâche** couvre la prise en charge jusqu’au commit, et **Job de réveil** correspond au réveil qui l’a exécutée. L’axe de la tâche est découpé en attente file, prise / setup et calcul. Le job de réveil vide aussi le reste dû sur la même base, il dépasse donc normalement le bout-en-bout. | +| **Chaîne de tâches** | Toutes les tâches de la cascade, imbriquées sous la tâche qui les a mises en file d’attente, afin de voir l’origine de chaque branche. Les lots partiels issus d’une même étape forment une file série et restent à plat sur un seul niveau au lieu d’être imbriqués plus profondément. Chaque ligne indique son état, les étapes du plan, la **Cible d’écriture** (la table et les champs que cette tâche met à jour), la **Complexité estimée**, la profondeur de cascade, l’heure de mise en file d’attente et la durée. | | **Propagation des champs** | Les champs lus et écrits par l’exécution, ainsi que le cheminement de la modification entre eux. Le bleu en pointillé est l’origine ayant conduit à cette écriture, le gris est une entrée non écrite lors de cette exécution, le vert est écrit lors de cette exécution, et les flèches représentent des dépendances de champs ou des sauts de liens plutôt que l’ordre des étapes. Seules les origines qui atteignent réellement les écritures de cette exécution sont dessinées. Utilisez **Développer** pour ouvrir le graphique en plein écran lorsqu’une chaîne large est difficile à suivre en ligne. | Le registre de traçabilité n’enregistre que les tâches créées après le déploiement de cette fonctionnalité et conserve 7 jours d’historique. Une tâche plus ancienne affiche les informations de sa file d’attente sans graphique de propagation. Une tâche initiale que le worker n’a pas encore planifiée n’affiche que ses champs déclencheurs. Lorsqu’une modification n’a produit aucune écriture calculée en aval, le graphique l’indique : aucun élément ne dépendait de ces champs via une formule, une recherche, un rollup ou un titre de lien. diff --git a/fr/basic/admin-panel/overview.mdx b/fr/basic/admin-panel/overview.mdx index 7d1487d0..8e23452b 100644 --- a/fr/basic/admin-panel/overview.mdx +++ b/fr/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ Le panneau d’administration regroupe ses pages par objectif : ### Opérations et audit - **[Gestion des automatisations](/fr/basic/admin-panel/automation-management)** : affichez le statut d’exécution des automatisations et l’historique des exécutions -- **[Opérations de requête de Table](/fr/basic/admin-panel/table-query-ops)** : analysez les risques des requêtes de Table et les recommandations d’index +- **[Opérations de requête de Table](/fr/basic/admin-panel/table-query-ops)** : configurez la couverture de recherche par Table, créez des index et suivez les résultats - **[Boîte d’envoi calculée](/fr/basic/admin-panel/computed-outbox)** : surveillez la livraison des tâches calculées, la santé de la file et l’arriéré de la base de données - **[File de génération IA](/fr/basic/admin-panel/ai-generation-queue)** : examinez le statut de génération des Champs IA dans l’instance auto-hébergée actuelle - **[Agent sandbox](/fr/basic/admin-panel/sandbox-agent)** : configurez et gérez l’Agent sandbox diff --git a/fr/basic/admin-panel/table-query-ops.mdx b/fr/basic/admin-panel/table-query-ops.mdx index 8cb90485..a82dd6b8 100644 --- a/fr/basic/admin-panel/table-query-ops.mdx +++ b/fr/basic/admin-panel/table-query-ops.mdx @@ -1,86 +1,74 @@ --- title: "Opérations de requêtes de Table" -description: "Examinez les recommandations de risque liées aux requêtes pour les Tables lentes et confirmez les améliorations de la base de données." +description: "Examinez la couverture de recherche et les index Table par Table, configurez la recherche, créez des index et suivez les résultats." --- Disponible à partir du plan Business auto-hébergé Chemin : Administration système → Opérations de requêtes de Table -Utilisez **Opérations de requêtes de Table** lorsque les Vues, filtres, relations ou recherches sur une grande Table deviennent lents. Un analyseur en arrière-plan surveille la charge de travail des requêtes et transforme ses observations en recommandations. La page les répertorie afin que les administrateurs de l’instance puissent examiner les éléments probants, analyser une Table spécifique plus en détail et confirmer toute modification de base de données. +Utilisez **Recherche et index de Table** lorsque les Vues, filtres, relations ou recherches sur une grande Table deviennent lents. Teable surveille la charge des requêtes en arrière-plan et résume chaque Table : comment elle est recherchée aujourd’hui, quels Champs sont couverts, quels index physiques existent et combien de requêtes lentes ont été observées récemment. Les administrateurs de l’instance configurent ici la couverture de recherche, créent des index et suivent les résultats. -Les compteurs au-dessus de la liste résument la situation actuelle : périodes d’observation, requêtes, requêtes lentes, délais d’expiration, recommandations ouvertes et acceptées, tâches en cours et en échec, ainsi que le nombre de chemins d’accès de recherche prêts ou dégradés. +La page met uniquement des tâches en file d’attente, elle ne modifie jamais la base de données directement. Chaque changement s’exécute de façon asynchrone en arrière-plan : vérifiez le résultat sous **Tâches / historique**. -## Examiner les recommandations +## Trouver la Table à traiter -La page s’ouvre sur **Recommandations**, classées par priorité. L’analyseur évalue le risque d’une requête par rapport à l’intensité d’utilisation de la Table ; les éléments qui méritent le plus une action apparaissent donc en premier. +La page s’ouvre sur la liste des Tables. Les boutons d’état en haut portent leur propre compteur et réduisent la liste : -Recherchez par ID de Table, de Base ou d’Espace pour filtrer toutes les recommandations ; tout autre texte filtre ce qui est déjà affiché à l’écran. Les filtres de statut et de risque réduisent davantage la liste. - -Chaque entrée indique l’Espace, la Base et la Table auxquels elle appartient. Développez une ligne pour lire les éléments probants de la recommandation, la décision du système et les diagnostics SQL : - -| Section | Ce qu’elle indique | +| État | Signification | | --- | --- | -| **Déclencheur** | L’origine de la recommandation : trafic de requêtes observé, configuration d’une Vue enregistrée ou configuration d’un Champ de relation. Un déclencheur de Vue enregistrée signifie qu’aucune requête lente n’a encore été observée ; la configuration seule a soulevé le risque. | -| **Chemin d’accès** | La fréquence à laquelle cette Table a été atteinte par analyse séquentielle plutôt que par analyse d’index. | -| **Raisons** | Des causes compréhensibles telles qu’une grande Table, l’absence d’index utile sur les Champs de filtre ou de tri, un tri coûteux ou des délais d’expiration observés. | -| **Forme de requête** | Les Champs spécifiques filtrés et triés, avec le type de correspondance utilisé pour chacun. | -| **Index proposé** | Les Champs que la recommandation indexerait, et pourquoi. | +| **Toutes les Tables** | Toutes les Tables observées. | +| **Nécessite une attention** | Tables présentant des requêtes lentes, des délais dépassés, des recommandations en attente ou des tâches en échec. Commencez ici. | +| **Recherche indexée** | Tables dont la couverture de recherche est déjà configurée. | +| **Non configurée** | Tables sans couverture de recherche. | +| **Indisponible** | Tables qui ne peuvent pas utiliser la recherche indexée pour l’instant. La ligne en indique la raison. | -**Analyse approfondie** ouvre l’espace de travail d’analyse avec cette Table déjà renseignée. +Le champ de recherche accepte les noms ou identifiants de Table, de Base et d’Espace. Le tri se fait par **Plus de requêtes lentes** ou par **Nom de Table**. La **Fenêtre d’observation** couvre la dernière heure, 24 heures ou 7 jours, et toutes les valeurs d’observation de la liste suivent cette fenêtre. -Lorsque l’analyseur détecte de nombreuses recherches de sous-chaînes dans une Table, il génère une recommandation **GIN de texte généré** pour l’ensemble de cette Table au lieu d’un index par Champ. Une telle ligne propose **Créer un chemin de recherche** à la place de **Analyse approfondie**, et **Ajouter un index** n’apparaît pas. La recommandation se ferme automatiquement une fois que la Table dispose du chemin. +Chaque ligne donne le nombre de lignes et la taille estimés de la Table, les requêtes et requêtes lentes de la fenêtre, la méthode de recherche actuelle et la couverture des Champs, le nombre d’index de filtre/tri, ainsi que les recommandations en attente et les tâches actives. Cliquez sur le nom d’une Table pour ouvrir son détail. -**Créer un chemin de recherche** ouvre une boîte de dialogue qui exécute une analyse à blanc (dry run) de la Table sans quitter la page. Elle indique le fournisseur d’index du candidat, le nombre de Champs couverts, les lignes estimées et le coût `EXPLAIN` avant et après. Saisissez un terme de recherche d’exemple au moins aussi long que la longueur minimale affichée : il sert uniquement à la validation et n’est pas conservé. Sur une grande Table, cochez aussi la case de la fenêtre de maintenance. À la confirmation, Teable revalide le candidat puis active le chemin de recherche. +## Configurer la couverture de recherche -Si l’analyse ne renvoie aucun candidat, la boîte de dialogue en explique la raison et n’applique rien. Une Table large est refusée, car Teable ne construit pas pour elle de document de recherche couvrant tous les Champs, et un terme plus long n’y change rien. Utilisez alors **Analyser les Champs sélectionnés** pour n’analyser dans l’espace de travail que les Champs réellement recherchés. +L’onglet **Couverture de recherche** indique la méthode de recherche actuelle de la Table, le nombre de Champs couverts et l’état de couverture de chaque Champ. **Afficher les champs non couverts** restreint la liste aux Champs pas encore inclus ; les Champs marqués **Non éligible** ne peuvent pas alimenter un index de recherche par sous-chaîne. -Deux autres onglets se trouvent à côté : - -| Onglet | Ce qu’il affiche | -| --- | --- | -| **Tables actives** | Les Tables les plus sollicitées, avec les requêtes, requêtes lentes, délais d’expiration et la durée de requête la plus longue. | -| **Tâches** | Les tâches de remédiation créées par Teable, avec le statut, les tentatives, le worker et la dernière erreur. | +La couverture est explicite. Les Champs ajoutés ensuite ne sont pas inclus automatiquement : reconfigurez la Table pour les intégrer. Les recherches hors couverture, ou dont le terme est trop court, retombent sur un balayage `ILIKE` plus lent. -Une bannière apparaît au-dessus de la liste lorsqu’un problème de configuration bloque le processus : des chemins d’accès de recherche sont configurés alors que l’indicateur d’exécution est désactivé, certaines Tables ont un chemin d’accès obsolète ou en attente de reconstruction et leur recherche est silencieusement revenue à l’analyse `ILIKE` plus lente, ou la tâche en file d’attente la plus ancienne attend depuis suffisamment longtemps pour suggérer qu’aucun worker ne la traite. Corrigez ce que la bannière indique avant d’agir sur les recommandations ci-dessous. +Choisissez **Configurer la recherche** sur une Table jamais configurée, ou **Mettre à jour la sélection / reconstruire** sur une Table déjà configurée. La boîte de dialogue demande : -### Lire le badge de décision +| Élément | Ce que vous saisissez | +| --- | --- | +| **Fournisseur de recherche** | `pg_bigm` ou `pg_trgm`. Si l’extension manque, la boîte de dialogue indique ce qui manque et qui peut l’installer. | +| **Texte de recherche représentatif** | Un texte que vos utilisateurs rechercheraient réellement. Il sert à vérifier la sémantique de sous-chaîne et à collecter des éléments de plan, et n’est jamais enregistré. S’il est trop court, la boîte de dialogue indique la longueur minimale. | +| **Champs** | Sélectionnez les Champs que les utilisateurs recherchent vraiment. Ne sélectionnez pas tout sur une Table large : construire un document de recherche pour chaque Champ coûte cher. | -Chaque recommandation porte la dernière décision prise par le système à son sujet : +**Analyser et simuler** exécute la modification sans la valider et rend le nombre de Champs couverts, le nombre de lignes estimé, la présence d’éléments de plan et l’impact d’une création ou d’une reconstruction. Les Tables estimées à 50 000 lignes ou plus, ainsi que celles de taille inconnue, exigent en plus la confirmation de la fenêtre de maintenance. Choisissez ensuite **Confirmer et mettre la tâche en file d’attente**. -| Badge | Signification | -| --- | --- | -| **Nécessite une confirmation manuelle** | Seul un administrateur peut appliquer celle-ci. | -| **Simulation · s’exécuterait automatiquement** | La recommandation répond aux critères d’acceptation, mais l’exécution automatique n’est pas activée ; rien n’a donc changé. | -| **Exécution automatique en cours** / **Exécution automatique terminée** | L’exécution automatique a accepté la recommandation et l’a appliquée. | -| **Échec de la post-vérification · nouvelle tentative différée** | Une modification automatique n’a pas réussi la vérification. Teable attend plus longtemps avant de réessayer cette Table. | -| **Période de refroidissement** | Le même périmètre a été modifié récemment ; le système attend donc. | -| **En attente** / **Exécution automatique non appliquée** | Les éléments probants du plan ou la taille de la Table n’ont pas atteint le seuil requis pour une exécution automatique. | +Créer ou reconstruire la couverture de recherche génère une colonne de recherche et un index GIN. L’opération peut réécrire toute la Table, poser des verrous et interrompre brièvement la recherche indexée. Planifiez-la pendant une fenêtre de maintenance. -Par défaut, Teable enregistre uniquement les décisions et crée des enregistrements de recommandations et de tâches ; il ne modifie pas votre base de données de lui-même. L’exécution automatique est facultative via `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto` et, même dans ce cas, elle s’applique uniquement aux petites Tables dont le plan d’exécution montre une nette amélioration des coûts. Tout le reste attend un administrateur. +La boîte de dialogue renvoie un accusé de réception de tâche, pas un résultat. Fermez-la et suivez la tâche sous **Tâches / historique**. Soumettre à nouveau la même modification renvoie la tâche existante. -### Ajouter l’index proposé +## Gérer les index de filtre et de tri -Lorsqu’une recommandation propose un index avec lequel vous êtes d’accord, cliquez sur **Ajouter un index** dans la ligne. La confirmation accepte la recommandation et exécute `CREATE INDEX CONCURRENTLY` sur la Table PostgreSQL sous-jacente ; si la validation du plan a été ignorée, Teable crée tout de même l’index à partir des Champs recommandés. La boîte de dialogue répète les éléments probants afin que vous puissiez les vérifier une dernière fois. +L’onglet **Index de filtre / tri** répertorie les index physiques qui servent les conditions de filtre et les tris de cette Table, chacun avec sa validité, l’indication de gestion par Teable, sa taille et sa définition. Ils sont gérés séparément des index de recherche par sous-chaîne. -Pour une Table estimée à 50 000 lignes ou plus, la boîte de dialogue vous demande de confirmer qu’une fenêtre de maintenance est prévue avant que le bouton ne devienne disponible. Une création concurrente sur une grande Table prend du temps et ajoute de la charge pendant son exécution. +En dessous, les **Actions en attente** regroupent les recommandations d’index du système et précisent si des éléments de plan les étayent. **Examiner la création d’index** montre l’index proposé, la base de données d’exécution et les éléments probants ; après votre confirmation, Teable exécute `CREATE INDEX CONCURRENTLY` de façon asynchrone. Les grandes Tables et celles de taille inconnue exigent ici aussi la confirmation de la fenêtre de maintenance. -Teable indique ensuite **Index créé** ou **Recommandation acceptée et mise en file d’attente**. Dans le second cas, suivez la tâche sous **Tâches**. Si la recommandation ne possède aucune colonne physique exécutable associée, **Ajouter un index** reste désactivé et l’indique ; utilisez plutôt l’espace de travail d’analyse pour approfondir. +Cette page ne supprime pas d’index. Les index non gérés et les index système peuvent protéger des contraintes ou servir d’autres charges de travail ; ils ne sont pas touchés. -## Exécuter une analyse approfondie +## Diagnostiquer des requêtes précises -Ouvrez **Espace de travail d’analyse** pour analyser un périmètre à la demande, par exemple lorsqu’un utilisateur signale une Table lente qui n’a pas encore de recommandation. +Lorsqu’une Table est signalée comme lente sans recommandation associée, ouvrez l’onglet **Diagnostic des requêtes** et choisissez **Analyser les requêtes**. L’analyse lit uniquement les formes de requêtes enregistrées et les éléments de plan disponibles ; elle ne crée rien. -| Type d’analyse | Utilisez-le pour | -| --- | --- | -| **Requêtes et index** | Identifier les risques liés aux requêtes et les améliorations possibles des index. | -| **Recherche de sous-chaînes** | Vérifier si un chemin d’accès de recherche de sous-chaînes pourrait accélérer les recherches contenant une sous-chaîne sans modifier leur comportement de correspondance. | +La conclusion est **Opportunités d’index étayées par un plan trouvées**, **Aucune opportunité d’index confirmée par les plans disponibles** ou **Éléments insuffisants**. Des éléments insuffisants ne signifient pas qu’un balayage séquentiel a eu lieu : une observation lente ne prouve pas à elle seule que le chemin d’accès est en cause. En dessous figure chaque requête concernée, avec l’origine (trafic réel ou configuration de Vue enregistrée) et le coût de plan estimé avant et après l’index proposé (coût de plan, pas des millisecondes). -Choisissez **Table**, **Base** ou **Espace**, saisissez l’ID correspondant et sélectionnez un type d’analyse. Commencez par **Table** lorsque vous savez déjà quelle Table est lente. +## Suivre les résultats -Cliquez sur **Générer le rapport de requêtes** ou **Générer le rapport de recherche**. Le rapport résume les risques détectés et les prochaines actions recommandées. Pour un rapport de recherche, **EXPLAIN d’une recherche d’exemple** est facultatif. Ajoutez un exemple pour vérifier la compatibilité des résultats, les plans de requête et les temps de requête répétés pour le chemin d’accès de recherche de sous-chaînes proposé. Teable n’enregistre pas la valeur de l’exemple. +L’onglet **Tâches / historique** comporte trois parties : -Le rapport de requêtes ne modifie pas la base de données. L’application d’une recommandation de recherche de sous-chaînes nécessite un **EXPLAIN d’une recherche d’exemple** et la confirmation d’un administrateur. +- **Tâches** : les tâches d’arrière-plan de cette Table, avec statut, nombre de tentatives, type de tâche et cause de l’échec. Lorsqu’une tâche a fini par réussir après un échec, l’erreur est signalée comme une tentative antérieure. +- **Historique de configuration de recherche** : le fournisseur, le statut et la liste des Champs de chaque configuration de couverture passée. +- **Historique des recommandations** : les recommandations acceptées, écartées ou remplacées. -Pour une grande Table, examinez l’impact et planifiez toute modification confirmée pendant une fenêtre de maintenance appropriée. +L’historique ne charge que les entrées les plus récentes. S’il y en a davantage, une ligne au-dessus de la liste en donne le total. +Tant qu’une tâche est en file d’attente ou en cours sur une Table, les boutons de configuration de la recherche et de création d’index restent désactivés. Attendez la fin de la tâche. diff --git a/fr/basic/credential.mdx b/fr/basic/credential.mdx index c943cb99..d564c234 100644 --- a/fr/basic/credential.mdx +++ b/fr/basic/credential.mdx @@ -26,7 +26,7 @@ Cliquez sur votre avatar en bas à gauche, puis ouvrez **Paramètres** → **Int Une connexion s’ajoute avec **Connecter un nouveau compte**. Quand une autorisation expire, la connexion propose **Reconnecter**. -Chaque identifiant indique combien de ressources l’utilisent actuellement. **Afficher** ouvre la liste des applications et automatisations concernées, où vous pouvez **Retirer l’autorisation** pour l’une d’elles. +Chaque identifiant indique combien de ressources l’utilisent actuellement. **Afficher** ouvre la liste des applications et automatisations concernées, chacune accompagnée de la date de l’autorisation, où vous pouvez **Retirer l’autorisation** pour l’une d’elles. ## Accorder un identifiant à une application ou une automatisation diff --git a/fr/basic/field/common/show-as.mdx b/fr/basic/field/common/show-as.mdx index 426d0d8f..e39c84c3 100644 --- a/fr/basic/field/common/show-as.mdx +++ b/fr/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "Affichage interactif" -description: "Modifiez l’affichage des valeurs de champ et le comportement au clic pour les URL, les e-mails, les numéros de téléphone et les graphiques numériques." +description: "Modifiez l’affichage des valeurs de champ et le comportement au clic pour les e-mails, les numéros de téléphone et les graphiques numériques." --- L’affichage interactif modifie l’apparence des valeurs de Champ et leur comportement lors d’un clic. Il ne change pas le type de Champ, mais uniquement la manière dont les utilisateurs voient le contenu du Champ et interagissent avec lui. @@ -9,7 +9,6 @@ L’affichage interactif modifie l’apparence des valeurs de Champ et leur comp | Affichage | Description | | --- | --- | -| URL | Affiche le texte sous forme d’adresse web. Un clic ouvre le lien dans un navigateur | | E-mail | Affiche le texte sous forme d’adresse e-mail. Un clic ouvre l’application de messagerie par défaut | | Téléphone | Affiche le texte sous forme de numéro de téléphone. Un clic lance une action d’appel, selon la prise en charge de l’appareil | diff --git a/fr/basic/field/long-text.mdx b/fr/basic/field/long-text.mdx index e56fb310..878cb9ee 100644 --- a/fr/basic/field/long-text.mdx +++ b/fr/basic/field/long-text.mdx @@ -46,5 +46,5 @@ Le Champ **Texte long** convient aux contenus développés qui nécessitent des ## Remarques -- Texte long ne prend pas en charge l’affichage interactif URL, E-mail ou Téléphone. Il prend uniquement en charge le texte brut et le Markdown. -- Si le contenu ne nécessite pas de saut de ligne et doit utiliser l’affichage URL, E-mail ou Téléphone, utilisez un Champ **Texte sur une seule ligne**. +- Les adresses web contenues dans le texte deviennent automatiquement des liens cliquables, sans aucun réglage. Dans un Enregistrement développé, un bouton situé près du champ de saisie répertorie toutes les adresses détectées dans la cellule. +- Texte long ne prend pas en charge l’affichage interactif E-mail ou Téléphone. Utilisez un Champ **Texte sur une seule ligne** lorsque vous voulez cliquer sur une adresse ou un numéro pour écrire ou appeler. diff --git a/fr/basic/field/single-line-text.mdx b/fr/basic/field/single-line-text.mdx index 0f024383..d3362b87 100644 --- a/fr/basic/field/single-line-text.mdx +++ b/fr/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ Pour les notes, résumés ou descriptions qui nécessitent des sauts de ligne, u +## Détection automatique des liens + +Les adresses web contenues dans une cellule deviennent automatiquement des liens cliquables, sans aucun réglage. Sont reconnues les adresses commençant par `https://` ou `www.`, ainsi que les domaines courants comme `teable.ai`. Si une valeur contient plusieurs adresses, chacune devient un lien distinct. Dans un Enregistrement développé, un bouton situé près du champ de saisie répertorie toutes les adresses détectées dans la cellule. + +Les noms de fichiers et les numéros de version tels que `readme.md` ou `v1.2.3` ne sont pas pris pour des adresses. + ## Mode d’affichage -Texte sur une seule ligne prend en charge quatre modes d’affichage : +Texte sur une seule ligne prend en charge trois modes d’affichage : | Mode d’affichage | Utilité | Comportement au clic | | --- | --- | --- | -| Par défaut | Noms, titres, identifiants et autres textes bruts | Aucun comportement supplémentaire au clic | -| URL | Adresses web | Ouvre l’URL dans le navigateur par défaut | +| Par défaut | Noms, titres, identifiants et autres textes bruts | Les adresses deviennent des liens et s’ouvrent au clic | | E-mail | Adresses e-mail | Ouvre l’application de messagerie par défaut | | Téléphone | Numéros de téléphone | Ouvre l’application de communication de l’appareil. Sur mobile, les utilisateurs peuvent appeler directement le numéro | @@ -45,7 +50,7 @@ Le mode d’affichage modifie l’apparence et le comportement de la valeur lors ## Utilisations courantes -- **Gestion des coordonnées client** : créez un Champ « Site web de l’entreprise » et définissez-le sur **URL** afin que le site s’ouvre en cliquant dessus. Créez un Champ « Téléphone » et définissez-le sur **Téléphone** afin que les utilisateurs mobiles puissent appeler d’un seul geste. +- **Gestion des coordonnées client** : créez un Champ « Site web de l’entreprise » et saisissez-y l’adresse afin que le site s’ouvre en cliquant dessus. Créez un Champ « Téléphone » et définissez-le sur **Téléphone** afin que les utilisateurs mobiles puissent appeler d’un seul geste. - **Gestion des commandes ou des contrats** : créez un Champ « Identifiant de commande » ou « Identifiant de contrat » pour la recherche, le filtrage et la mise en correspondance avec des systèmes externes. - **Statut initial d’un ticket** : créez un Champ « Étape actuelle » et définissez sa valeur par défaut sur « Nouveau ». Si l’étape provient d’un flux de travail fixe, utilisez plutôt un Champ **Sélection unique**. - **Extraction et concaténation de texte** : référencez Texte sur une seule ligne dans des formules pour extraire des segments d’identifiants, concaténer des noms d’affichage ou normaliser le format du texte. @@ -53,5 +58,5 @@ Le mode d’affichage modifie l’apparence et le comportement de la valeur lors ## Remarques - Texte sur une seule ligne est destiné aux contenus courts. La touche Entrée confirme généralement la saisie. Utilisez **Texte long** pour les notes, les résumés d’articles et les autres contenus longs. -- URL, E-mail et Téléphone sont des modes d’affichage. Le Champ reste de type Texte sur une seule ligne et peut toujours être trié, filtré et traité avec des fonctions de texte. +- E-mail et Téléphone sont des modes d’affichage. Le Champ reste de type Texte sur une seule ligne et peut toujours être trié, filtré et traité avec des fonctions de texte. - Texte sur une seule ligne ne limite pas les valeurs à des options prédéfinies. Utilisez **Sélection unique** ou **Sélection multiple** pour les statuts, les catégories et les priorités qui exigent des valeurs cohérentes. diff --git a/it/basic/admin-panel/computed-outbox.mdx b/it/basic/admin-panel/computed-outbox.mdx index 827481fa..50123581 100644 --- a/it/basic/admin-panel/computed-outbox.mdx +++ b/it/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ Quando un valore calcolato appare errato o arriva in ritardo, apri **Discendenza | Sezione | Domanda a cui risponde | | --- | --- | | Riepilogo | Latenza end-to-end, momento della modifica dell'origine, momento della convergenza del valore e Tabella e Campi che hanno attivato l'esecuzione. Il badge **Calcolo in corso** indica che la catena è ancora in esecuzione. | -| **Sequenza temporale** | Quando l'esecuzione è stata accodata, avviata e completata o non è riuscita. | -| **Catena di attività** | Ogni attività della cascata, nidificata sotto quella che l'ha accodata, per mostrare l'origine di ciascun ramo. Ogni riga mostra stato, passaggi del piano, **Destinazione di scrittura** (la Tabella e i Campi aggiornati dall'attività), **Righe da aggiornare**, profondità della cascata, ora di accodamento e durata. | +| **Sequenza temporale** | Tre assi affiancati: **End-to-end** va dalla modifica sorgente alla convergenza delle scritture calcolate, **Questo task** copre dal claim al commit e **Job wakeup** è il wakeup che lo ha eseguito. L'asse del task è suddiviso in attesa in coda, claim / setup e calcolo. Il job di wakeup svuota anche altro lavoro scaduto sullo stesso database, quindi di norma dura più dell'end-to-end. | +| **Catena di attività** | Ogni attività della cascata, nidificata sotto quella che l'ha accodata, per mostrare l'origine di ciascun ramo. I batch parziali della stessa fase sono una coda seriale e restano sullo stesso livello invece di annidarsi ulteriormente. Ogni riga mostra stato, passaggi del piano, **Destinazione di scrittura** (la Tabella e i Campi aggiornati dall'attività), **Complessità stimata**, profondità della cascata, ora di accodamento e durata. | | **Propagazione dei Campi** | Quali Campi sono stati letti e scritti dall'esecuzione e come la modifica si è propagata tra essi. Il blu tratteggiato rappresenta l'origine che ha condotto alla scrittura, il grigio un input non scritto in questa esecuzione, il verde un elemento scritto in questa esecuzione e le frecce le dipendenze tra Campi o i passaggi attraverso collegamenti, non l'ordine dei passaggi. Vengono disegnate soltanto le origini che raggiungono effettivamente le scritture di questa esecuzione. Usa **Espandi** per aprire il grafico a schermo intero quando una catena ampia è difficile da seguire nel contenuto. | Il registro della discendenza registra soltanto le attività create dopo il rilascio di questa funzionalità e conserva 7 giorni di cronologia. Un'attività più vecchia mostra i dati della coda senza un grafico di propagazione. Un'attività iniziale non ancora pianificata dal worker mostra soltanto i Campi di attivazione. Quando una modifica non ha prodotto scritture calcolate a valle, il grafico lo segnala: nessun elemento dipendeva da quei Campi tramite formula, lookup, rollup o titolo del collegamento. diff --git a/it/basic/admin-panel/overview.mdx b/it/basic/admin-panel/overview.mdx index 2d6f638c..d2f3fffd 100644 --- a/it/basic/admin-panel/overview.mdx +++ b/it/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ L'Amministrazione di sistema raggruppa le pagine in base allo scopo: ### Operazioni e controllo - **[Gestione delle Automazioni](/it/basic/admin-panel/automation-management)**: visualizza lo stato e la cronologia delle esecuzioni delle Automazioni -- **[Operazioni sulle query delle Tabelle](/it/basic/admin-panel/table-query-ops)**: analizza i rischi delle query delle Tabelle e i suggerimenti per gli indici +- **[Operazioni sulle query delle Tabelle](/it/basic/admin-panel/table-query-ops)**: configura la copertura di ricerca per Tabella, crea indici e segui i risultati - **[Outbox dei calcoli](/it/basic/admin-panel/computed-outbox)**: monitora la consegna delle attività di calcolo, lo stato della coda e l'arretrato del database - **[Coda di generazione IA](/it/basic/admin-panel/ai-generation-queue)**: esamina lo stato di generazione dei Campi IA nell'istanza Self-hosted corrente - **[Sandbox Agent](/it/basic/admin-panel/sandbox-agent)**: configura e gestisce Sandbox Agent diff --git a/it/basic/admin-panel/table-query-ops.mdx b/it/basic/admin-panel/table-query-ops.mdx index 085b3195..7f2c3946 100644 --- a/it/basic/admin-panel/table-query-ops.mdx +++ b/it/basic/admin-panel/table-query-ops.mdx @@ -1,85 +1,74 @@ --- title: "Operazioni sulle query delle Tabelle" -description: "Esamina i suggerimenti relativi ai rischi delle query per le Tabelle lente e conferma i miglioramenti del database." +description: "Esamina copertura di ricerca e indici Tabella per Tabella, configura la ricerca, crea indici e segui i risultati." --- Disponibile per il piano Business Self-hosted e versioni successive Percorso: Amministrazione di sistema → Operazioni sulle query delle Tabelle -Usa **Operazioni sulle query delle Tabelle** quando Viste, filtri, relazioni o ricerche in una Tabella di grandi dimensioni diventano lenti. Un analizzatore in background osserva il carico delle query e trasforma quanto rilevato in suggerimenti. La pagina li elenca affinché gli amministratori dell'istanza possano esaminare le prove, analizzare più a fondo una Tabella specifica e confermare eventuali modifiche al database. +Usa **Ricerca e indici delle Tabelle** quando Viste, filtri, relazioni o ricerche in una Tabella di grandi dimensioni diventano lenti. Teable osserva il carico delle query in background e riepiloga ogni Tabella: come viene cercata oggi, quali Campi sono coperti, quali indici fisici esistono e quante query lente sono state rilevate di recente. Gli amministratori dell'istanza configurano qui la copertura di ricerca, creano indici e seguono i risultati. -I contatori sopra l'elenco riepilogano la situazione corrente: finestre di osservazione, richieste, query lente, timeout, suggerimenti aperti e accettati, attività in esecuzione e non riuscite e numero di percorsi di accesso per la ricerca pronti o degradati. +La pagina si limita ad accodare attività e non modifica mai il database in modo diretto. Ogni modifica viene eseguita in background in modo asincrono, quindi verifica l'esito in **Attività / cronologia**. -## Esaminare i suggerimenti +## Individuare la Tabella su cui intervenire -La pagina si apre su **Suggerimenti**, ordinati per priorità. L'analizzatore pondera il rischio di una query rispetto all'intensità d'uso della Tabella, così le voci per cui è più opportuno intervenire vengono mostrate per prime. +La pagina si apre sull'elenco delle Tabelle. I pulsanti di stato in alto riportano i rispettivi conteggi e restringono l'elenco: -Cerca per ID di Tabella, Base o Spazio per filtrare tutti i suggerimenti; qualsiasi altro testo filtra ciò che è già visualizzato. I filtri di stato e rischio restringono ulteriormente l'elenco. - -Ogni voce indica lo Spazio, la Base e la Tabella a cui appartiene. Espandi una riga per leggere le prove alla base del suggerimento, la decisione del sistema e la diagnostica SQL: - -| Sezione | Informazioni fornite | +| Stato | Significato | | --- | --- | -| **Trigger** | Origine del suggerimento: traffico delle query osservato, configurazione di una Vista salvata o configurazione di un Campo di relazione. Un trigger basato su una Vista salvata indica che non è stata ancora osservata alcuna query lenta; è la configurazione stessa ad aver segnalato il rischio. | -| **Percorso di accesso** | Frequenza con cui questa Tabella è stata raggiunta tramite scansione sequenziale anziché tramite scansione dell'indice. | -| **Motivi** | Cause leggibili, ad esempio una Tabella di grandi dimensioni, l'assenza di un indice utile nei Campi di filtro o ordinamento, un ordinamento costoso o timeout osservati. | -| **Forma della query** | Campi specifici filtrati e ordinati, con il tipo di corrispondenza utilizzato da ciascuno. | -| **Indice proposto** | Campi che il suggerimento indicizzerebbe e relativa motivazione. | +| **Tutte le Tabelle** | Tutte le Tabelle osservate. | +| **Richiede attenzione** | Tabelle con query lente, timeout, suggerimenti in sospeso o attività non riuscite. Parti da qui. | +| **Ricerca indicizzata** | Tabelle con copertura di ricerca già configurata. | +| **Non configurata** | Tabelle senza copertura di ricerca. | +| **Non disponibile** | Tabelle che al momento non possono usare la ricerca indicizzata. La riga ne indica il motivo. | -**Analisi approfondita** apre l'area di lavoro di analisi con la Tabella già compilata. +Il campo di ricerca accetta nomi o ID di Tabella, Base e Spazio. L'ordinamento è per **Più query lente** oppure **Nome Tabella**. La **Finestra di osservazione** copre l'ultima ora, 24 ore o 7 giorni, e tutti i dati di osservazione dell'elenco seguono quella finestra. -Quando l'analizzatore rileva numerose ricerche di sottostringhe in una Tabella, genera un unico suggerimento **GIN per testo generato** per l'intera Tabella, anziché un indice per ogni Campo. Tale riga offre **Crea percorso di ricerca** al posto di **Analisi approfondita** e **Aggiungi indice** non viene visualizzato. Il suggerimento si chiude automaticamente quando la Tabella dispone del percorso. +Ogni riga riporta righe e dimensioni stimate della Tabella, richieste e query lente della finestra, metodo di ricerca corrente e copertura dei Campi, numero di indici di filtro/ordinamento, oltre ai suggerimenti in sospeso e alle attività attive. Fai clic sul nome di una Tabella per aprirne il dettaglio. -**Crea percorso di ricerca** apre una finestra che esegue un'analisi di prova (dry run) della Tabella senza lasciare la pagina. La finestra mostra il provider di indice del candidato, il numero di Campi coperti, le righe stimate e il costo `EXPLAIN` prima e dopo. Inserisci un termine di ricerca di esempio lungo almeno quanto la lunghezza minima indicata: serve solo alla verifica e non viene salvato. Su una Tabella grande, conferma anche la casella della finestra di manutenzione. Alla conferma Teable verifica di nuovo il candidato e attiva il percorso di ricerca. +## Configurare la copertura di ricerca -Se l'analisi non produce candidati, la finestra ne spiega il motivo e non esegue nulla. Una Tabella molto larga viene rifiutata perché Teable non crea per essa un documento di ricerca su tutti i Campi, e un termine più lungo non cambia questo esito. Usa **Analizza i Campi selezionati** per passare all'area di lavoro di analisi e analizzare solo i Campi in cui gli utenti cercano davvero. +La scheda **Copertura di ricerca** mostra il metodo di ricerca corrente della Tabella, quanti Campi sono coperti e lo stato di copertura di ciascun Campo. **Mostra campi non coperti** limita l'elenco ai Campi non ancora inclusi; i Campi contrassegnati come **Non idoneo** non possono contribuire a un indice di ricerca per sottostringa. -Accanto sono presenti altre due schede: +La copertura è esplicita. I Campi aggiunti in seguito non vengono inclusi automaticamente: riconfigura la Tabella per integrarli. Le ricerche fuori copertura, o con un termine troppo corto, ripiegano su una scansione `ILIKE` più lenta. -| Scheda | Contenuto | -| --- | --- | -| **Tabelle attive** | Le Tabelle più utilizzate, con richieste, query lente, timeout e durata massima delle query. | -| **Attività** | Attività correttive create da Teable, con stato, tentativi, worker e ultimo errore. | +Scegli **Configura ricerca** su una Tabella mai configurata oppure **Aggiorna selezione / ricostruisci** su una già configurata. La finestra di dialogo richiede: -Sopra l'elenco viene visualizzato un banner quando un problema di configurazione blocca il processo: i percorsi di accesso per la ricerca sono configurati mentre il flag del runtime è disattivato, alcune Tabelle hanno un percorso di accesso obsoleto o in attesa di ricostruzione e la ricerca è passata automaticamente alla scansione `ILIKE` più lenta oppure l'attività accodata più vecchia è rimasta in attesa abbastanza a lungo da suggerire che nessun worker la stia elaborando. Correggi quanto segnalato dal banner prima di intervenire sui suggerimenti sottostanti. +| Voce | Cosa inserire | +| --- | --- | +| **Provider di ricerca** | `pg_bigm` o `pg_trgm`. Se manca l'estensione, la finestra indica che cosa manca e chi può installarla. | +| **Testo di ricerca rappresentativo** | Un testo che i tuoi utenti cercherebbero davvero. Serve a verificare la semantica per sottostringa e a raccogliere prove dal piano, e non viene mai salvato. Se è troppo corto, la finestra indica la lunghezza minima. | +| **Campi** | Seleziona i Campi che gli utenti cercano davvero. Su una Tabella ampia non selezionarli tutti: creare un documento di ricerca per ogni Campo è oneroso. | -### Leggere il badge della decisione +**Analizza ed esegui la simulazione** applica la modifica senza confermarla e riporta il numero di Campi coperti, le righe stimate, l'eventuale presenza di prove dal piano e l'impatto della creazione o della ricostruzione. Le Tabelle stimate a 50.000 righe o più, e quelle di dimensioni sconosciute, richiedono anche la conferma della finestra di manutenzione. Poi scegli **Conferma e accoda attività**. -Ogni suggerimento riporta la decisione più recente presa dal sistema: +La creazione o la ricostruzione della copertura di ricerca genera una colonna di ricerca e un indice GIN. L'operazione può riscrivere l'intera Tabella e mantenere lock, e la ricerca indicizzata si interrompe brevemente durante l'esecuzione. Pianificala in una finestra di manutenzione. -| Badge | Significato | -| --- | --- | -| **Richiede conferma manuale** | Soltanto un amministratore può applicarlo. | -| **Simulazione · verrebbe eseguito automaticamente** | Il suggerimento soddisfa i criteri di accettazione, ma l'esecuzione automatica non è abilitata, quindi non è stata apportata alcuna modifica. | -| **Esecuzione automatica in corso** / **Eseguito automaticamente** | L'esecuzione automatica ha accettato e applicato il suggerimento. | -| **Verifica successiva non riuscita · nuovo tentativo ritardato** | Una modifica automatica non ha superato la verifica. Teable attende più a lungo prima di riprovare su quella Tabella. | -| **Periodo di attesa** | Lo stesso ambito è stato modificato di recente, quindi il sistema attende. | -| **In sospeso** / **Esecuzione automatica non applicata** | Le prove del piano o le dimensioni della Tabella non hanno soddisfatto i requisiti per l'esecuzione automatica. | +Quello che la finestra restituisce è una ricevuta dell'attività, non un risultato. Chiudila e segui l'attività in **Attività / cronologia**. Inviando di nuovo la stessa modifica viene restituita l'attività già esistente. -Per impostazione predefinita, Teable registra soltanto le decisioni e crea i Record dei suggerimenti e delle attività; non modifica autonomamente il database. L'esecuzione automatica è facoltativa e si abilita tramite `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`; anche in tal caso viene applicata soltanto alle Tabelle di piccole dimensioni il cui piano di esecuzione mostra un chiaro miglioramento dei costi. Tutto il resto attende l'intervento di un amministratore. +## Gestire gli indici di filtro e ordinamento -### Aggiungere l'indice proposto +La scheda **Indici di filtro / ordinamento** elenca gli indici fisici che servono le condizioni di filtro e gli ordinamenti di questa Tabella, ciascuno con validità, indicazione se è gestito da Teable, dimensione e definizione. Sono gestiti separatamente dagli indici di ricerca per sottostringa. -Quando un suggerimento propone un indice che approvi, fai clic su **Aggiungi indice** nella riga. La conferma accetta il suggerimento ed esegue `CREATE INDEX CONCURRENTLY` sulla Tabella PostgreSQL sottostante; se la convalida del piano è stata ignorata, Teable crea comunque l'indice dai Campi consigliati. La finestra di dialogo ripete le prove affinché tu possa controllarle un'ultima volta. +Sotto, le **Azioni in sospeso** raccolgono i suggerimenti di indice del sistema e indicano se sono supportati da prove del piano. **Esamina la creazione dell'indice** mostra l'indice proposto, il database su cui viene eseguito e le prove; dopo la conferma, Teable esegue `CREATE INDEX CONCURRENTLY` in modo asincrono. Anche qui le Tabelle grandi o di dimensioni sconosciute richiedono la conferma della finestra di manutenzione. -Per una Tabella stimata in almeno 50.000 righe, la finestra di dialogo richiede di confermare che sia attiva una finestra di manutenzione prima di rendere disponibile il pulsante. La creazione simultanea su una Tabella di grandi dimensioni richiede tempo e aggiunge carico durante l'esecuzione. +Questa pagina non elimina indici. Gli indici non gestiti e quelli di sistema possono proteggere vincoli o servire altri carichi di lavoro, quindi non vengono toccati. -Teable segnala quindi **Indice creato** oppure **Suggerimento accettato e accodato**. Nel secondo caso, segui l'attività nella scheda **Attività**. Se il suggerimento non dispone di una colonna fisica eseguibile sottostante, **Aggiungi indice** rimane disabilitato e ne indica il motivo; usa invece l'area di lavoro di analisi per approfondire. +## Diagnosticare query specifiche -## Eseguire un'analisi approfondita +Quando una Tabella viene segnalata come lenta e nessun suggerimento la riguarda, apri la scheda **Diagnosi delle query** e scegli **Analizza query**. L'analisi legge soltanto le forme di query salvate e le prove del piano disponibili, e non crea nulla. -Apri **Area di lavoro di analisi** per analizzare un ambito su richiesta, ad esempio quando un utente segnala una Tabella lenta per cui non esiste ancora alcun suggerimento. +La conclusione è **Trovate opportunità di indice supportate dal piano**, **Nessuna opportunità di indice confermata dai piani disponibili** oppure **Prove insufficienti**. Prove insufficienti non significano che si sia verificata una scansione sequenziale: una singola osservazione lenta non dimostra che il percorso di accesso sia la causa. Sotto viene elencata ogni query interessata, con l'indicazione se proviene dal traffico reale o da una configurazione di Vista salvata, e il costo di piano stimato prima e dopo l'indice proposto (costo di piano, non millisecondi). -| Tipo di analisi | Utilizzo | -| --- | --- | -| **Query e indici** | Individuare i rischi delle query e i possibili miglioramenti degli indici. | -| **Ricerca di sottostringhe** | Verificare se un percorso di accesso per la ricerca di sottostringhe può velocizzare le ricerche «contiene» senza modificarne il comportamento di corrispondenza. | +## Seguire i risultati -Scegli **Tabella**, **Base** o **Spazio**, inserisci l'ID corrispondente e seleziona un tipo di analisi. Inizia da **Tabella** quando sai già quale Tabella è lenta. +La scheda **Attività / cronologia** ha tre parti: -Fai clic su **Genera report delle query** o **Genera report della ricerca**. Il report riepiloga i rischi rilevati e le azioni successive consigliate. Per un report della ricerca, la **ricerca di esempio EXPLAIN** è facoltativa. Aggiungi un esempio per controllare la compatibilità dei risultati, i piani delle query e la temporizzazione delle query ripetute per il percorso di accesso proposto per la ricerca di sottostringhe. Teable non salva il valore di esempio. +- **Attività**: le attività in background di questa Tabella, con stato, numero di tentativi, tipo di attività e motivo dell'errore. Se un'attività è poi riuscita dopo un errore, l'errore è contrassegnato come tentativo precedente. +- **Cronologia della configurazione di ricerca**: provider, stato ed elenco dei Campi di ogni configurazione di copertura precedente. +- **Cronologia dei suggerimenti**: suggerimenti accettati, ignorati o sostituiti. -Il report delle query non modifica il database. L'applicazione di un suggerimento per la ricerca di sottostringhe richiede una **ricerca di esempio EXPLAIN** e la conferma di un amministratore. +La cronologia carica soltanto le voci più recenti. Se ce ne sono altre, una riga sopra l'elenco ne indica il totale. -Per una Tabella di grandi dimensioni, esamina l'impatto e pianifica qualsiasi modifica confermata in una finestra di manutenzione adeguata. +Finché una Tabella ha un'attività accodata o in esecuzione, i pulsanti per configurare la ricerca e creare indici restano disabilitati. Attendi la fine dell'attività. diff --git a/it/basic/credential.mdx b/it/basic/credential.mdx index 80d618ff..73458f4d 100644 --- a/it/basic/credential.mdx +++ b/it/basic/credential.mdx @@ -26,7 +26,7 @@ Fai clic sul tuo avatar in basso a sinistra e apri **Impostazioni** → **Integr Le connessioni si aggiungono con **Connetti nuovo account**. Quando un'autorizzazione scade, la connessione propone **Ricollega**. -Ogni credenziale indica da quante risorse è usata al momento. **Visualizza** apre l'elenco di app e Automazioni, dove puoi **Rimuovere l'autorizzazione** a una singola voce. +Ogni credenziale indica da quante risorse è usata al momento. **Visualizza** apre l'elenco di app e Automazioni, ciascuna con la data dell'autorizzazione, dove puoi **Rimuovere l'autorizzazione** a una singola voce. ## Concedere una credenziale a un'app o a un'Automazione diff --git a/it/basic/field/common/show-as.mdx b/it/basic/field/common/show-as.mdx index 212122c2..05e2cca5 100644 --- a/it/basic/field/common/show-as.mdx +++ b/it/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "Visualizzazione interattiva" -description: "Modifica la visualizzazione dei valori dei Campi e il comportamento al clic, ad esempio per URL, email, numeri di telefono e grafici numerici." +description: "Modifica la visualizzazione dei valori dei Campi e il comportamento al clic, ad esempio per email, numeri di telefono e grafici numerici." --- La visualizzazione interattiva modifica l'aspetto dei valori dei Campi e il loro comportamento al clic. Non cambia il tipo di Campo, ma soltanto il modo in cui gli utenti visualizzano e usano il contenuto del Campo. @@ -9,7 +9,6 @@ La visualizzazione interattiva modifica l'aspetto dei valori dei Campi e il loro | Visualizzazione | Descrizione | | --- | --- | -| URL | Mostra il testo come indirizzo web. Facendo clic, il link si apre in un browser | | Email | Mostra il testo come indirizzo email. Facendo clic, si apre l'app di posta predefinita | | Telefono | Mostra il testo come numero di telefono. Facendo clic, viene avviata un'azione di chiamata, se supportata dal dispositivo | diff --git a/it/basic/field/long-text.mdx b/it/basic/field/long-text.mdx index 26dfe048..fda5c05d 100644 --- a/it/basic/field/long-text.mdx +++ b/it/basic/field/long-text.mdx @@ -46,5 +46,5 @@ Il Campo **Testo lungo** è pensato per contenuti più estesi che richiedono int ## Note -- Testo lungo non supporta la visualizzazione interattiva URL, Email o Telefono. Supporta soltanto testo normale e Markdown. -- Se il contenuto non richiede interruzioni di riga e deve utilizzare la visualizzazione URL, Email o Telefono, usa un Campo **Testo su una riga**. +- Gli indirizzi web contenuti nel testo diventano link cliccabili in automatico, senza impostare nulla. Nel Record espanso, un pulsante accanto al campo di inserimento elenca tutti gli indirizzi trovati nella cella. +- Testo lungo non supporta la visualizzazione interattiva Email o Telefono. Usa un Campo **Testo su una riga** quando vuoi fare clic su un indirizzo o un numero per scrivere o chiamare. diff --git a/it/basic/field/single-line-text.mdx b/it/basic/field/single-line-text.mdx index 70046d99..5dae2068 100644 --- a/it/basic/field/single-line-text.mdx +++ b/it/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ Per note, riepiloghi o descrizioni che richiedono interruzioni di riga, usa **[T +## Rilevamento automatico dei link + +Gli indirizzi web contenuti in una cella diventano link cliccabili in automatico, senza impostare nulla. Vengono riconosciuti gli indirizzi che iniziano con `https://` o `www.` e i domini più comuni come `teable.ai`. Se un valore contiene più indirizzi, ciascuno diventa un link a sé. Nel Record espanso, un pulsante accanto al campo di inserimento elenca tutti gli indirizzi trovati nella cella. + +Nomi di file e numeri di versione come `readme.md` o `v1.2.3` non vengono scambiati per indirizzi. + ## Modalità di visualizzazione -Testo su una riga supporta quattro modalità di visualizzazione: +Testo su una riga supporta tre modalità di visualizzazione: | Modalità di visualizzazione | Utile per | Comportamento al clic | | --- | --- | --- | -| Predefinita | Nomi, titoli, ID e altro testo normale | Nessun comportamento aggiuntivo al clic | -| URL | Indirizzi web | Apre l'URL nel browser predefinito | +| Predefinita | Nomi, titoli, ID e altro testo normale | Gli indirizzi diventano link e si aprono al clic | | Email | Indirizzi email | Apre l'app di posta elettronica predefinita | | Telefono | Numeri di telefono | Apre l'app di comunicazione del dispositivo. Sui dispositivi mobili, gli utenti possono chiamare direttamente il numero | @@ -45,7 +50,7 @@ La modalità di visualizzazione modifica l'aspetto e il comportamento del valore ## Utilizzi comuni -- **Gestione dei contatti dei clienti**: crea un Campo "Sito web aziendale" e impostalo su **URL**, in modo che il sito si apra con un clic. Crea un Campo "Telefono" e impostalo su **Telefono**, in modo che gli utenti mobili possano chiamare con un solo tocco. +- **Gestione dei contatti dei clienti**: crea un Campo "Sito web aziendale" e digita l'indirizzo, in modo che il sito si apra con un clic. Crea un Campo "Telefono" e impostalo su **Telefono**, in modo che gli utenti mobili possano chiamare con un solo tocco. - **Gestione di ordini o contratti**: crea un Campo "ID ordine" o "ID contratto" per la ricerca, i filtri e la corrispondenza con sistemi esterni. - **Stato iniziale dei ticket**: crea un Campo "Fase corrente" e imposta il valore predefinito su "Nuovo". Se la fase deriva da un flusso di lavoro fisso, usa invece un Campo **Selezione singola**. - **Estrazione e concatenazione del testo**: fai riferimento a Testo su una riga nelle formule per estrarre segmenti di ID, concatenare nomi visualizzati o normalizzare il formato del testo. @@ -53,5 +58,5 @@ La modalità di visualizzazione modifica l'aspetto e il comportamento del valore ## Note - Testo su una riga è destinato a contenuti brevi. In genere il tasto Invio conferma l'inserimento. Usa **Testo lungo** per note, riepiloghi di articoli e altri contenuti estesi. -- URL, Email e Telefono sono modalità di visualizzazione. Il Campo rimane di tipo Testo su una riga e può continuare a essere ordinato, filtrato ed elaborato con funzioni di testo. +- Email e Telefono sono modalità di visualizzazione. Il Campo rimane di tipo Testo su una riga e può continuare a essere ordinato, filtrato ed elaborato con funzioni di testo. - Testo su una riga non limita i valori a opzioni predefinite. Usa **Selezione singola** o **Selezione multipla** per stati, categorie e priorità che richiedono valori coerenti. diff --git a/ja/basic/admin-panel/computed-outbox.mdx b/ja/basic/admin-panel/computed-outbox.mdx index 7e002e5f..7adaa2e2 100644 --- a/ja/basic/admin-panel/computed-outbox.mdx +++ b/ja/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ description: "システム管理でBullMQの配信と計算タスクのバック | セクション | 確認できる内容 | | --- | --- | | 概要 | エンドツーエンドのレイテンシ、ソースが変更された日時、値が収束した日時、実行をトリガーしたテーブルとフィールド。**計算中**バッジは、チェーンがまだ実行中であることを示します。| -| **タイムライン** | 実行がエンキュー、開始、完了、または失敗した日時。| -| **タスクチェーン** | カスケード内のすべてのタスクを、エンキュー元のタスクの下に入れ子で表示し、分岐元を確認できます。各行には、状態、計画ステップ、**書き込み先**（そのタスクが更新するテーブルとフィールド）、**変更行**、カスケードの深さ、エンキュー日時、所要時間が表示されます。| +| **タイムライン** | 3本のタイムラインが並びます。**エンドツーエンド**はソース変更から計算書き込みの収束まで、**このタスク**は取得からコミットまで、**ウェイクアップ**はそれを実行したウェイクアップ処理です。タスクの軸はキュー待ち、取得準備、計算書き込みに分かれています。ウェイクアップ処理は同一DBの他の期限切れ作業も片付けるため、エンドツーエンドより長くなるのが通常です。| +| **タスクチェーン** | カスケード内のすべてのタスクを、エンキュー元のタスクの下に入れ子で表示し、分岐元を確認できます。同じステージから分割された部分バッチは直列のキューであり、さらに入れ子にせず同じ階層に並べて表示されます。各行には、状態、計画ステップ、**書き込み先**（そのタスクが更新するテーブルとフィールド）、**推定複雑度**、カスケードの深さ、エンキュー日時、所要時間が表示されます。| | **フィールドの伝播** | 実行が読み書きしたフィールドと、その間を変更がどのように伝わったかを示します。青い破線はこの書き込みにつながった起点、灰色は今回の実行では書き込まれなかった入力、緑は今回書き込まれた項目を表します。矢印はステップの順序ではなく、フィールドの依存関係またはリンク経由の移動を示します。今回の実行の書き込みへ実際に到達する起点だけが描画されます。横長のチェーンをインラインで追いにくい場合は、**展開**を使用してグラフを全画面で開きます。| 系統台帳には、この機能の提供開始後に作成されたタスクだけが記録され、履歴は7日間保持されます。それ以前のタスクには、伝播グラフなしでキュー情報が表示されます。ワーカーがまだ計画していないシードタスクには、トリガーフィールドだけが表示されます。変更によって下流の計算書き込みが発生しなかった場合、グラフにはその旨が表示されます。数式、ルックアップ、ロールアップ、リンクタイトルを通じて、それらのフィールドに依存する項目がなかったことを意味します。 diff --git a/ja/basic/admin-panel/overview.mdx b/ja/basic/admin-panel/overview.mdx index 0fe13494..a581dc60 100644 --- a/ja/basic/admin-panel/overview.mdx +++ b/ja/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ description: "Teableのセルフホスト版システム管理では、インス ### 運用と監査 - **[オートメーション管理](/ja/basic/admin-panel/automation-management)**: オートメーションの実行状態と実行履歴を表示します -- **[テーブルクエリ運用](/ja/basic/admin-panel/table-query-ops)**: テーブルクエリのリスクとインデックスの推奨事項を分析します +- **[テーブルクエリ運用](/ja/basic/admin-panel/table-query-ops)**: テーブルごとに検索カバレッジを設定し、インデックスを作成して結果を追跡します - **[計算済みOutbox](/ja/basic/admin-panel/computed-outbox)**: 計算タスクの配信、キューの稼働状態、データベースのバックログを監視します - **[AI生成キュー](/ja/basic/admin-panel/ai-generation-queue)**: 現在のセルフホストインスタンスにおけるAIフィールド生成の状態を確認します - **[サンドボックスエージェント](/ja/basic/admin-panel/sandbox-agent)**: サンドボックスエージェントを設定、管理します diff --git a/ja/basic/admin-panel/table-query-ops.mdx b/ja/basic/admin-panel/table-query-ops.mdx index 5ca33430..32f270fb 100644 --- a/ja/basic/admin-panel/table-query-ops.mdx +++ b/ja/basic/admin-panel/table-query-ops.mdx @@ -1,85 +1,74 @@ --- title: "テーブルクエリ運用" -description: "低速なテーブルに対するクエリリスクの推奨事項を確認し、データベースの改善を確定します。" +description: "テーブルごとに検索カバレッジとインデックスを確認し、検索の設定、インデックス作成、実行結果の追跡を行います。" --- セルフホストのBusinessプラン以上で利用できます パス：システム管理 → テーブルクエリ運用 -大規模なテーブルでビュー、フィルター、リレーション、検索が遅くなった場合は、**テーブルクエリ運用**を使用します。バックグラウンドアナライザーがクエリのワークロードを監視し、観測結果を推奨事項に変換します。このページには推奨事項が一覧表示されるため、インスタンス管理者は根拠を確認し、特定のテーブルを詳しく分析して、データベースの変更を確定できます。 +大規模なテーブルでビュー、フィルター、リレーション、検索が遅くなった場合は、**テーブル検索とインデックス**を使用します。Teableはバックグラウンドでクエリの負荷を観測し、テーブルごとに現状をまとめます。現在どの方式で検索しているか、どのフィールドがカバーされているか、どの物理インデックスがあるか、直近の低速クエリはどれくらいかが分かります。インスタンス管理者は、ここで検索カバレッジの設定、インデックスの作成、実行結果の追跡を行います。 -一覧の上にあるカウンターには、観測期間、リクエスト、低速クエリ、タイムアウト、未対応および承認済みの推奨事項、実行中および失敗したタスク、検索アクセスパスが利用可能または低下状態にある件数など、現在の状況がまとめて表示されます。 +このページはタスクを登録するだけで、データベースを直接変更することはありません。すべての変更はバックグラウンドで非同期に実行されるため、結果は**タスク / 履歴**で確認してください。 -## 推奨事項を確認する +## 対応が必要なテーブルを探す -ページを開くと、**推奨事項**が優先度順に表示されます。アナライザーは、クエリのリスクとテーブルの使用頻度を考慮するため、最も対応する価値の高い項目が先に表示されます。 +ページを開くとテーブル一覧が表示されます。上部の状態ボタンにはそれぞれの件数が付いており、一覧を絞り込めます。 -テーブル、ベース、スペースIDで検索すると、すべての推奨事項を対象に絞り込めます。その他のテキストでは、現在画面に表示されている項目を絞り込みます。ステータスとリスクのフィルターを使用すると、一覧をさらに絞り込めます。 - -各項目には、所属するスペース、ベース、テーブルの名前が表示されます。行を展開すると、推奨事項の根拠、システムの判断、SQL診断を確認できます。 - -| セクション | 示される内容 | +| 状態 | 意味 | | --- | --- | -| **トリガー** | 推奨事項の発生元：観測されたクエリトラフィック、保存済みビューの設定、またはリレーションフィールドの設定。保存済みビューがトリガーの場合、低速クエリはまだ観測されておらず、設定自体によってリスクが検出されています。| -| **アクセスパス** | このテーブルへのアクセスに、シーケンシャルスキャンとインデックススキャンがそれぞれ使用された頻度。| -| **理由** | 大規模なテーブル、フィルターまたは並べ替えフィールドに有効なインデックスがない、高コストな並べ替え、観測されたタイムアウトなど、わかりやすく示した原因。| -| **クエリ形状** | 絞り込みと並べ替えに使用される具体的なフィールド、および各フィールドで使用する一致の種類。| -| **提案インデックス** | 推奨事項によってインデックスが作成されるフィールドと、その理由。| +| **すべてのテーブル** | 観測対象のすべてのテーブル。| +| **要対応** | 低速クエリ、タイムアウト、未処理の推奨事項、失敗したタスクがあるテーブル。ここから着手します。| +| **インデックス検索** | 検索カバレッジを設定済みのテーブル。| +| **未設定** | 検索カバレッジがまだないテーブル。| +| **利用不可** | 現在インデックス検索を利用できないテーブル。行に理由が表示されます。| -**詳細分析**をクリックすると、そのテーブルが入力済みの状態で分析ワークスペースが開きます。 +検索ボックスでは、テーブル、ベース、スペースの名前とIDを指定できます。並べ替えは**低速クエリが多い順**または**テーブル名**です。**観測期間**は直近1時間、24時間、7日間から選べ、一覧の観測値はすべてこの期間に従います。 -アナライザーがテーブル全体に対する高頻度の部分文字列検索を検出すると、フィールドごとのインデックスではなく、テーブル全体に対する**生成テキストGIN**の推奨事項が1件作成されます。この行には**詳細分析**の代わりに**検索パスを作成**が表示され、**インデックスを追加**は表示されません。テーブルにパスが設定されると、推奨事項は自動的に終了します。 +各行には、テーブルの推定行数とサイズ、期間内のリクエスト数と低速クエリ数、現在の検索方式とフィールドのカバー状況、フィルター/ソート用インデックスの数、未処理の推奨事項と実行中タスクの件数が表示されます。テーブル名をクリックすると詳細が開きます。 -**検索パスを作成**をクリックすると、同じページのダイアログでそのテーブルのドライランが実行され、画面を移動する必要はありません。ダイアログには、候補のインデックスプロバイダー、対象フィールド数、推定行数、適用前後の`EXPLAIN`コストが表示されます。ダイアログが示す最小文字数以上のサンプル検索語を入力してください。この語は検証にのみ使われ、保存されません。大きなテーブルでは、メンテナンスウィンドウのチェックボックスも確認します。確定すると、候補が再度検証されてから検索パスが有効になります。 +## 検索カバレッジを設定する -分析で候補が得られない場合は、ダイアログが理由を示し、何も実行しません。ワイドテーブルは、Teableが全フィールドを対象とする検索ドキュメントを作成しないため拒否され、検索語を長くしても結果は変わりません。その場合は**選択したフィールドを分析**をクリックし、分析ワークスペースでユーザーが実際に検索するフィールドだけを分析します。 +**検索カバレッジ**タブには、そのテーブルの現在の検索方式、カバー済みフィールド数、各フィールドのカバー状況が表示されます。**未カバーのフィールドを表示**を使うと、まだ含まれていないフィールドだけに絞り込めます。**対象外**と表示されたフィールドは、部分一致検索インデックスには使用できません。 -その横には、さらに2つのタブがあります。 +カバレッジは明示的に指定します。あとから追加したフィールドは自動では含まれないため、テーブルを設定し直して取り込んでください。カバレッジ外の検索や、検索語が短すぎる場合は、より遅い`ILIKE`スキャンにフォールバックします。 -| タブ | 表示内容 | -| --- | --- | -| **高負荷テーブル** | リクエスト数、低速クエリ数、タイムアウト数、最長クエリ時間を含む、最も使用頻度の高いテーブル。| -| **タスク** | Teableが作成した修復タスクと、そのステータス、試行回数、ワーカー、最後のエラー。| +未設定のテーブルでは**検索を設定**、設定済みのテーブルでは**フィールド選択の更新 / 再構築**を選びます。ダイアログでは次の項目を指定します。 -設定上の問題によって処理が滞っている場合、一覧の上にバナーが表示されます。たとえば、ランタイムフラグがオフの状態で検索アクセスパスが設定されている場合、一部のテーブルでアクセスパスが古いか再構築待ちになり、検索が通知なく低速な`ILIKE`スキャンへフォールバックしている場合、最も古いキュー内のタスクが長時間待機し、処理するワーカーがないと考えられる場合です。下の推奨事項に対応する前に、バナーで報告されている問題を修正してください。 +| 項目 | 入力内容 | +| --- | --- | +| **検索プロバイダー** | `pg_bigm`または`pg_trgm`。拡張機能が未導入の場合は、何が不足していて誰が対応できるかがダイアログに表示されます。| +| **代表的な検索語** | ユーザーが実際に検索しそうな語を入力します。部分一致のセマンティクス確認と実行計画の根拠収集に使われ、保存されることはありません。短すぎる場合は必要な最小文字数が表示されます。| +| **フィールド** | ユーザーが実際に検索するフィールドを選びます。列数の多いテーブルですべてを選ばないでください。全フィールドの検索ドキュメントを作るとコストが高くなります。| -### 判断バッジを確認する +**分析してドライラン**を実行すると、確定せずに変更を試算し、カバー対象のフィールド数、推定行数、実行計画の根拠の有無、新規作成または再構築による影響が表示されます。推定5万行以上のテーブルやサイズが不明なテーブルでは、メンテナンスウィンドウの確認チェックも必要です。内容を確認したら**確認してタスクを登録**を選びます。 -各推奨事項には、システムによる最新の判断が表示されます。 +検索カバレッジの作成や再構築では、検索用の列とGINインデックスが生成されます。テーブル全体の書き換えとロックが発生する可能性があり、その間はインデックス検索が一時的に中断されます。メンテナンスウィンドウ内で実施してください。 -| バッジ | 意味 | -| --- | --- | -| **手動確認が必要** | この推奨事項を適用できるのは管理者だけです。| -| **シャドウ · 自動実行対象** | 推奨事項は承認基準を満たしていますが、自動実行が有効でないため、変更は行われていません。| -| **自動実行中** / **自動実行済み** | 自動実行によって推奨事項が承認、適用されました。| -| **事後検証に失敗 · バックオフ中** | 自動変更が検証に合格しませんでした。Teableは、そのテーブルを再試行するまでの待機時間を延ばします。| -| **クールダウン中** | 同じスコープが最近変更されたため、システムが処理を見合わせています。| -| **保留** / **自動実行は未適用** | 計画の根拠またはテーブルサイズが、自動実行の基準を満たしていません。| +ダイアログに表示されるのはタスクの受付結果であり、実行結果ではありません。ダイアログを閉じ、**タスク / 履歴**で進捗を追ってください。同じ変更を再送信しても、既存のタスクが返されます。 -デフォルトでは、Teableは判断を記録して推奨事項とタスクのレコードを作成するだけで、データベースを自動的に変更しません。自動実行は`V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`で明示的に有効にする必要があります。有効にした場合も、実行計画で明確なコスト改善が示された小規模なテーブルにのみ適用されます。それ以外はすべて管理者の対応を待ちます。 +## フィルター/ソート用インデックスを管理する -### 提案されたインデックスを追加する +**フィルター / ソートインデックス**タブには、このテーブルのフィルター条件と並べ替えに使われる物理インデックスが、有効性、Teableによる管理の有無、サイズ、定義とともに表示されます。これらは部分一致検索インデックスとは別に管理されます。 -推奨事項で提案されたインデックスに同意する場合は、その行の**インデックスを追加**をクリックします。確定すると推奨事項が承認され、基盤となるPostgreSQLテーブルで`CREATE INDEX CONCURRENTLY`が実行されます。計画の検証がスキップされた場合でも、Teableは推奨フィールドからインデックスを構築します。ダイアログには根拠が再度表示されるため、最後にもう一度確認できます。 +その下の**保留中の操作**には、システムが提示したインデックスの推奨事項と、実行計画の根拠の有無が表示されます。**インデックス作成を確認**では、提案されたインデックス、実行先のデータベース、根拠を確認できます。確定すると、Teableは`CREATE INDEX CONCURRENTLY`を非同期で実行します。大規模なテーブルやサイズが不明なテーブルでは、ここでもメンテナンスウィンドウの確認が必要です。 -推定行数が50,000件以上のテーブルでは、ボタンを使用できるようになる前に、メンテナンス時間帯が確保されていることを確定するよう求められます。大規模テーブルでの並行構築には時間がかかり、実行中は負荷が増加します。 +このページからインデックスを削除することはできません。非管理インデックスやシステムインデックスは制約や他のクエリに使われている可能性があるため、削除の対象外です。 -その後、Teableは**インデックスを作成しました**または**推奨事項を承認し、キューへ追加しました**と報告します。後者の場合は、**タスク**でタスクを追跡します。推奨事項に実行可能な物理列がない場合、**インデックスを追加**は無効なままとなり、その理由が表示されます。代わりに分析ワークスペースを使用して、さらに調査してください。 +## 個別のクエリを診断する -## 詳細分析を実行する +特定のテーブルが遅いと報告されたものの、該当する推奨事項がない場合は、**クエリ診断**タブを開いて**クエリを分析**を選びます。分析は保存済みのクエリ形状と利用可能な実行計画の根拠を読み取るだけで、インデックスは作成しません。 -たとえば、まだ推奨事項がない低速テーブルがユーザーから報告された場合は、**分析ワークスペース**を開いて、スコープをオンデマンドで分析します。 +結果は、**実行計画に裏付けられたインデックス改善余地あり**、**利用可能な実行計画ではインデックス改善余地を確認できず**、**根拠不足**のいずれかです。根拠不足はシーケンシャルスキャンが起きた証拠にはなりません。低速クエリの観測だけでは、アクセスパスに問題があるとは言えないためです。その下には、対象のクエリごとに、実際のトラフィック由来か保存済みビュー設定由来かと、提案インデックス適用前後の推定プランコスト（ミリ秒ではなくプランコスト）が表示されます。 -| 分析の種類 | 用途 | -| --- | --- | -| **クエリとインデックス** | クエリリスクとインデックス改善の可能性を見つけます。| -| **部分文字列検索** | 一致動作を変更せずに、部分文字列検索アクセスパスによって包含検索を高速化できるか確認します。| +## 実行結果を追う -**テーブル**、**ベース**、**スペース**のいずれかを選択し、対応するIDを入力して、分析の種類を選びます。低速なテーブルがわかっている場合は、**テーブル**から始めてください。 +**タスク / 履歴**タブは3つの部分で構成されています。 -**クエリレポートを生成**または**検索レポートを生成**をクリックします。レポートには、検出されたリスクと推奨される次の操作がまとめられます。検索レポートの場合、**EXPLAINサンプル検索**は任意です。サンプルを追加すると、提案された部分文字列検索アクセスパスについて、結果の互換性、クエリ計画、繰り返しクエリの実行時間を確認できます。Teableはサンプル値を保存しません。 +- **タスク**：このテーブルのバックグラウンドタスク。状態、試行回数、タスク種別、失敗理由が表示されます。失敗したあとに最終的に成功したタスクでは、エラーが過去の試行として表示されます。 +- **検索設定履歴**：過去の検索カバレッジ設定のプロバイダー、状態、フィールド一覧。 +- **推奨事項の履歴**：承認、却下、置き換えとなった推奨事項。 -クエリレポートによってデータベースが変更されることはありません。部分文字列検索の推奨事項を適用するには、**EXPLAINサンプル検索**と管理者による確認が必要です。 +履歴は最新の一定件数のみ読み込まれます。それを超える場合は、一覧の上に総件数が表示されます。 -大規模なテーブルでは、影響を確認し、確定した変更を適切なメンテナンス時間帯に実施してください。 +テーブルに待機中または実行中のタスクがある間は、検索の設定とインデックス作成のボタンは無効になります。タスクの完了を待ってから操作してください。 diff --git a/ja/basic/credential.mdx b/ja/basic/credential.mdx index c7dc868d..40915a58 100644 --- a/ja/basic/credential.mdx +++ b/ja/basic/credential.mdx @@ -26,7 +26,7 @@ description: 自分の接続とシークレットを管理し、必要なアプ 接続は**新しいアカウントを接続**から追加します。認可の期限が切れた接続には**再接続**が表示されます。 -各認証情報には、現在いくつのリソースで使われているかが表示されます。**表示**をクリックするとアプリとオートメーションの一覧が開き、個別に**認可を解除**できます。 +各認証情報には、現在いくつのリソースで使われているかが表示されます。**表示**をクリックするとアプリとオートメーションの一覧が開きます。各項目には認可した日時が表示され、個別に**認可を解除**できます。 ## アプリやオートメーションへ付与する diff --git a/ja/basic/field/common/show-as.mdx b/ja/basic/field/common/show-as.mdx index 164555da..22467140 100644 --- a/ja/basic/field/common/show-as.mdx +++ b/ja/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "インタラクティブ表示" -description: "URL、メールアドレス、電話番号、数値チャートなど、フィールド値の表示とクリック時の動作を変更します。" +description: "メールアドレス、電話番号、数値チャートなど、フィールド値の表示とクリック時の動作を変更します。" --- インタラクティブ表示では、フィールド値の表示方法とクリック時の動作を変更します。フィールドタイプは変更されません。ユーザーがフィールドの内容をどのように表示し、操作するかだけが変わります。 @@ -9,7 +9,6 @@ description: "URL、メールアドレス、電話番号、数値チャートな | 表示 | 説明 | | --- | --- | -| URL | テキストをWebアドレスとして表示します。クリックするとブラウザでリンクが開きます | | メール | テキストをメールアドレスとして表示します。クリックするとデフォルトのメールアプリが開きます | | 電話 | テキストを電話番号として表示します。クリックすると、端末の対応状況に応じて発信操作が開始されます | diff --git a/ja/basic/field/long-text.mdx b/ja/basic/field/long-text.mdx index 9221e7f6..ee78396a 100644 --- a/ja/basic/field/long-text.mdx +++ b/ja/basic/field/long-text.mdx @@ -46,5 +46,5 @@ description: "改行を含む長いテキストを保存し、プレーンテキ ## 注意事項 -- 長文テキストは、URL、メール、電話のインタラクティブ表示には対応していません。プレーンテキストとMarkdownだけに対応しています。 -- 内容に改行が不要で、URL、メール、電話の表示を使用する場合は、**一行テキスト**フィールドを使用します。 +- 本文中のURLは、設定なしで自動的にクリックできるリンクになります。レコードを展開すると、入力欄の横のボタンからそのセル内のURLを一覧できます。 +- 長文テキストは、メールと電話のインタラクティブ表示には対応していません。アドレスや番号をクリックしてメール送信や発信をしたい場合は、**一行テキスト**フィールドを使用します。 diff --git a/ja/basic/field/single-line-text.mdx b/ja/basic/field/single-line-text.mdx index 8e766478..af99ff29 100644 --- a/ja/basic/field/single-line-text.mdx +++ b/ja/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ description: "名前、タイトル、ID、URL、メールアドレス、電話 +## URLの自動リンク化 + +セル内のURLは、設定なしで自動的にクリックできるリンクになります。`https://`や`www.`で始まるアドレスのほか、`teable.ai`のような一般的なドメインも認識されます。1つの値に複数のURLがある場合は、それぞれが個別のリンクになります。レコードを展開すると、入力欄の横のボタンからそのセル内のURLを一覧できます。 + +`readme.md`や`v1.2.3`のようなファイル名やバージョン番号がURLと誤認されることはありません。 + ## 表示モード -一行テキストは、次の4つの表示モードに対応しています。 +一行テキストは、次の3つの表示モードに対応しています。 | 表示モード | 適した用途 | クリック時の動作 | | --- | --- | --- | -| デフォルト | 名前、タイトル、IDなどのプレーンテキスト | 追加のクリック動作はありません | -| URL | Webアドレス | デフォルトのブラウザーでURLを開きます | +| デフォルト | 名前、タイトル、IDなどのプレーンテキスト | URLは自動でリンクになり、クリックで開きます | | メール | メールアドレス | デフォルトのメールアプリを開きます | | 電話 | 電話番号 | 端末の通信アプリを開きます。モバイルでは番号へ直接電話できます | @@ -45,7 +50,7 @@ description: "名前、タイトル、ID、URL、メールアドレス、電話 ## 一般的な使用例 -- **顧客の連絡先管理**：「企業Webサイト」フィールドを作成し、**URL**に設定すると、クリック時にWebサイトが開きます。「電話」フィールドを作成して**電話**に設定すると、モバイルユーザーは1回のタップで電話できます。 +- **顧客の連絡先管理**：「企業Webサイト」フィールドを作成してURLを入力すると、クリック時にWebサイトが開きます。「電話」フィールドを作成して**電話**に設定すると、モバイルユーザーは1回のタップで電話できます。 - **注文や契約の管理**：「注文ID」または「契約ID」フィールドを作成し、検索、絞り込み、外部システムとの照合に使用します。 - **チケットの初期ステータス**：「現在の段階」フィールドを作成し、デフォルト値を「新規」に設定します。段階が固定のワークフローに基づく場合は、代わりに**単一選択**フィールドを使用します。 - **テキストの抽出と連結**：数式で一行テキストを参照し、IDの一部を抽出したり、表示名を連結したり、テキスト形式を統一したりします。 @@ -53,5 +58,5 @@ description: "名前、タイトル、ID、URL、メールアドレス、電話 ## 注意事項 - 一行テキストは短い内容に使用します。通常、Enterキーで入力を確定します。メモ、記事の要約などの長い内容には**長文テキスト**を使用します。 -- URL、メール、電話は表示モードです。フィールドは一行テキストのままで、並べ替え、絞り込み、テキスト関数による処理を引き続き利用できます。 +- メールと電話は表示モードです。フィールドは一行テキストのままで、並べ替え、絞り込み、テキスト関数による処理を引き続き利用できます。 - 一行テキストでは、値が定義済みの選択肢に制限されません。一貫した値が必要なステータス、カテゴリー、優先度には、**単一選択**または**複数選択**を使用します。 diff --git a/ru/basic/admin-panel/computed-outbox.mdx b/ru/basic/admin-panel/computed-outbox.mdx index 740f4857..9ebf6c9d 100644 --- a/ru/basic/admin-panel/computed-outbox.mdx +++ b/ru/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ description: "Отслеживайте доставку BullMQ и накопле | Раздел | На какой вопрос отвечает | | --- | --- | | Сводка | Сквозная задержка, время изменения источника, время стабилизации значения, а также таблица и Поля, запустившие выполнение. Метка **Вычисляется** означает, что цепочка все еще выполняется. | -| **Временная шкала** | Когда выполнение было поставлено в очередь, запущено, завершено или завершилось с ошибкой. | -| **Цепочка задач** | Все задачи в каскаде, вложенные под задачей, которая поставила их в очередь, чтобы было видно источник каждой ветви. Каждая строка показывает состояние, шаги плана, **Цель записи** (таблицу и Поля, которые обновляет задача), **Измененные строки**, глубину каскада, время постановки в очередь и длительность. | +| **Временная шкала** | Три дорожки рядом: **Сквозная** идет от изменения источника до сходимости вычисляемых записей, **Этот task** от claim до commit, а **Wakeup-job** это то пробуждение, которое его выполнило. Дорожка задачи разбита на ожидание в очереди, claim / setup и расчёт. Wakeup-job попутно добирает просроченную работу той же БД, поэтому обычно длится дольше сквозной. | +| **Цепочка задач** | Все задачи в каскаде, вложенные под задачей, которая поставила их в очередь, чтобы было видно источник каждой ветви. Частичные пакеты, отделившиеся от одного этапа, представляют собой последовательную очередь и остаются на одном уровне, а не вкладываются глубже. Каждая строка показывает состояние, шаги плана, **Цель записи** (таблицу и Поля, которые обновляет задача), **Оценку сложности**, глубину каскада, время постановки в очередь и длительность. | | **Распространение Полей** | Какие Поля выполнение читало и записывало и как между ними прошло изменение. Синяя пунктирная линия обозначает источник, приведший к этой записи, серая — входные данные, не записанные в этом запуске, зеленая — данные, записанные в этом запуске, а стрелки обозначают зависимости Полей или переходы по ссылкам, а не порядок шагов. Отображаются только источники, которые действительно достигают записей этого запуска. Используйте **Развернуть**, чтобы открыть график во весь экран, если широкую цепочку сложно проследить в строке. | Реестр цепочки записывает только задачи, созданные после выпуска этой функции, и хранит историю 7 дней. Для более старой задачи отображаются факты очереди без графика распространения. Для начальной задачи, которую воркер еще не спланировал, отображаются только Поля-триггеры. Если изменение не привело к нижестоящим вычисляемым записям, график сообщает об этом: от этих Полей ничего не зависело через формулу, подстановку, свертку или заголовок ссылки. diff --git a/ru/basic/admin-panel/overview.mdx b/ru/basic/admin-panel/overview.mdx index e142f723..28689fdf 100644 --- a/ru/basic/admin-panel/overview.mdx +++ b/ru/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ description: "Панель администрирования самостоят ### Операции и аудит - **[Управление автоматизациями](/ru/basic/admin-panel/automation-management)**: Просматривайте статус запусков автоматизаций и историю запусков -- **[Операции запросов Таблиц](/ru/basic/admin-panel/table-query-ops)**: Анализируйте риски запросов таблиц и рекомендации по индексам +- **[Операции запросов Таблиц](/ru/basic/admin-panel/table-query-ops)**: Настраивайте покрытие поиска по таблицам, создавайте индексы и отслеживайте результаты - **[Вычисляемый исходящий буфер](/ru/basic/admin-panel/computed-outbox)**: Отслеживайте доставку вычисляемых задач, работоспособность очереди и накопившиеся задачи в базе данных - **[Очередь генерации ИИ](/ru/basic/admin-panel/ai-generation-queue)**: Проверяйте статус генерации ИИ-полей в текущем самостоятельно развернутом экземпляре - **[Агент песочницы](/ru/basic/admin-panel/sandbox-agent)**: Настраивайте Агент песочницы и управляйте им diff --git a/ru/basic/admin-panel/table-query-ops.mdx b/ru/basic/admin-panel/table-query-ops.mdx index b956122a..820452f7 100644 --- a/ru/basic/admin-panel/table-query-ops.mdx +++ b/ru/basic/admin-panel/table-query-ops.mdx @@ -1,86 +1,74 @@ --- title: "Операции с запросами таблиц" -description: "Просматривайте рекомендации по рискам запросов для медленных таблиц и подтверждайте улучшения базы данных." +description: "Просматривайте покрытие поиска и индексы по каждой таблице, настраивайте поиск, создавайте индексы и отслеживайте результаты." --- Доступно для самостоятельного развертывания на тарифе Business и выше Путь: Панель администрирования → Операции с запросами таблиц -Используйте **Операции с запросами таблиц**, когда представления, фильтры, связи или поиск в большой таблице становятся медленными. Фоновый анализатор отслеживает нагрузку запросов и преобразует наблюдения в рекомендации. На странице они перечислены, чтобы администраторы экземпляра могли изучить доказательства, глубже проанализировать конкретную таблицу и подтвердить любое изменение базы данных. +Используйте **Поиск и индексы таблиц**, когда представления, фильтры, связи или поиск в большой таблице становятся медленными. Teable отслеживает нагрузку запросов в фоне и сводит по каждой таблице: как в ней сейчас выполняется поиск, какие Поля покрыты, какие физические индексы есть и сколько медленных запросов зафиксировано за последнее время. Администраторы экземпляра настраивают здесь покрытие поиска, создают индексы и отслеживают результаты. -Счетчики над списком сводят текущую картину: окна наблюдения, запросы, медленные запросы, тайм-ауты, открытые и принятые рекомендации, выполняющиеся и неудачные задачи, а также количество готовых или деградировавших путей доступа для поиска. +Страница только ставит задачи в очередь и никогда не меняет базу данных напрямую. Каждое изменение выполняется в фоне асинхронно, поэтому проверяйте итог в разделе **Задачи / история**. -## Просмотр рекомендаций +## Найти нужную таблицу -Страница открывается на вкладке **Рекомендации**, упорядоченной по приоритету. Анализатор сопоставляет риск запроса с интенсивностью использования таблицы, поэтому сначала отображаются наиболее важные рекомендации. +Страница открывается со списком таблиц. Кнопки состояний вверху показывают собственные счетчики и сужают список: -Ищите по ID таблицы, Базы или Пространства, чтобы отфильтровать все рекомендации; любой другой текст фильтрует то, что уже находится на экране. Фильтры статуса и риска дополнительно сужают список. - -Каждая запись указывает пространство, базу и таблицу, к которым она относится. Разверните строку, чтобы прочитать доказательства, лежащие в основе рекомендации, системное решение и диагностику SQL: - -| Раздел | Что он сообщает | +| Состояние | Что означает | | --- | --- | -| **Триггер** | Источник рекомендации: наблюдаемый трафик запросов, сохраненная конфигурация представления или конфигурация поля связи. Триггер сохраненного представления означает, что медленный запрос еще не наблюдался; риск вызвала сама конфигурация. | -| **Путь доступа** | Как часто к этой таблице обращались через последовательное сканирование, а не через сканирование индекса. | -| **Причины** | Понятные причины, такие как большая таблица, отсутствие полезного индекса для полей фильтрации или сортировки, дорогостоящая сортировка либо наблюдаемые тайм-ауты. | -| **Структура запроса** | Конкретные фильтруемые и сортируемые поля с указанием типа сопоставления для каждого из них. | -| **Предлагаемый индекс** | Поля, которые будут индексированы по рекомендации, и причина этого. | +| **Все таблицы** | Все наблюдаемые таблицы. | +| **Требуют внимания** | Таблицы с медленными запросами, тайм-аутами, открытыми рекомендациями или неудачными задачами. Начинайте отсюда. | +| **Индексированный поиск** | Таблицы, для которых покрытие поиска уже настроено. | +| **Не настроено** | Таблицы без покрытия поиска. | +| **Недоступно** | Таблицы, которые сейчас не могут использовать индексированный поиск. Причина указана в строке. | -**Углубленный анализ** открывает рабочее пространство анализа с уже заполненной этой таблицей. +Поле поиска принимает названия и идентификаторы таблиц, Баз и Пространств. Сортировать можно по параметру **Больше всего медленных запросов** или **Название таблицы**. **Окно наблюдения** охватывает последний час, 24 часа или 7 дней, и все показатели наблюдений в списке следуют этому окну. -Когда анализатор обнаруживает интенсивный поиск подстрок по таблице, он создает одну рекомендацию **GIN для сгенерированного текста** для всей таблицы вместо индекса для каждого поля. Такая строка предлагает **Создать путь поиска** вместо **Углубленного анализа**, а **Добавить индекс** не отображается. Рекомендация закрывается сама, когда у таблицы появляется этот путь. +В каждой строке указаны оценочное число строк и размер таблицы, запросы и медленные запросы за окно, текущий метод поиска и покрытие Полей, число индексов фильтрации/сортировки, а также количество открытых рекомендаций и активных задач. Нажмите название таблицы, чтобы открыть подробности. -**Создать путь поиска** открывает диалог, который выполняет пробный прогон (dry run) для таблицы прямо на этой странице. В диалоге показаны поставщик индекса для кандидата, число охваченных полей, оценка строк и стоимость `EXPLAIN` до и после. Введите пример поискового запроса не короче указанной минимальной длины: он нужен только для проверки и не сохраняется. Для большой таблицы дополнительно отметьте флажок об окне обслуживания. После подтверждения Teable еще раз проверяет кандидата и включает путь поиска. +## Настроить покрытие поиска -Если анализ не дал кандидата, диалог объясняет причину и ничего не выполняет. Широкая таблица отклоняется, потому что Teable не строит для нее поисковый документ по всем полям, и более длинный запрос этого не изменит. Нажмите **Анализировать выбранные поля**, чтобы в рабочем пространстве анализа разобрать только те поля, по которым действительно ищут. +Вкладка **Покрытие поиска** показывает текущий метод поиска таблицы, число покрытых Полей и состояние покрытия каждого Поля. **Показать непокрытые поля** оставляет в списке только еще не включенные Поля; Поля с пометкой **Не подходит** не могут участвовать в индексе подстрочного поиска. -Рядом находятся еще две вкладки: - -| Вкладка | Что она показывает | -| --- | --- | -| **Активные таблицы** | Наиболее загруженные таблицы с запросами, медленными запросами, тайм-аутами и самой долгой длительностью запроса. | -| **Задачи** | Задачи устранения проблем, созданные Teable, со статусом, попытками, обработчиком и последней ошибкой. | +Покрытие задается явно. Поля, добавленные позже, не включаются автоматически: настройте таблицу заново, чтобы их учесть. Поиск за пределами покрытия, а также слишком короткий запрос, откатывается к более медленному сканированию `ILIKE`. -Баннер появляется над списком, когда проблему удерживает ошибка конфигурации: пути доступа для поиска настроены, но флаг среды выполнения выключен; у некоторых таблиц путь доступа устарел или ожидает перестроения, поэтому их поиск незаметно вернулся к более медленному сканированию `ILIKE`; либо самая старая задача в очереди ожидает достаточно долго, чтобы предположить отсутствие обработчика, который ее получает. Исправьте то, о чем сообщает баннер, прежде чем работать с рекомендациями ниже. +Для таблицы, которая еще не настраивалась, выберите **Настроить поиск**, а для уже настроенной выберите **Обновить выбор / перестроить**. В диалоге нужно указать: -### Чтение метки решения +| Пункт | Что вводить | +| --- | --- | +| **Поставщик поиска** | `pg_bigm` или `pg_trgm`. Если расширение не установлено, диалог сообщает, чего не хватает и кто может это исправить. | +| **Показательный текст поиска** | Текст, который пользователи действительно ищут. Он проверяет семантику подстроки и собирает данные плана выполнения и никогда не сохраняется. Если он слишком короткий, диалог называет минимальную длину. | +| **Поля** | Выберите Поля, по которым пользователи ищут на самом деле. На широкой таблице не выбирайте все: строить поисковый документ по каждому Полю дорого. | -Каждая рекомендация содержит последнее решение, принятое системой: +**Анализ и пробный запуск** выполняет изменение без фиксации и показывает число покрытых Полей, оценочное число строк, наличие данных плана выполнения и последствия создания или перестроения. Для таблиц с оценкой от 50 000 строк, а также неизвестного размера, дополнительно требуется подтверждение окна обслуживания. Затем выберите **Подтвердить и поставить задачу в очередь**. -| Метка | Значение | -| --- | --- | -| **Требуется ручное подтверждение** | Применить эту рекомендацию может только администратор. | -| **Теневой режим · будет выполнено автоматически** | Рекомендация соответствует критериям принятия, но автоматическое выполнение не включено, поэтому ничего не изменилось. | -| **Выполняется автоматически** / **Выполнено автоматически** | Автоматическое выполнение приняло рекомендацию и применило ее. | -| **Проверка после выполнения не пройдена · повторная попытка будет отложена** | Автоматическое изменение не прошло проверку. Teable будет дольше ждать перед следующей попыткой для этой таблицы. | -| **Период ожидания** | Та же область была недавно изменена, поэтому система откладывает действие. | -| **Отложено** / **Автоматическое выполнение не применено** | Доказательства плана или размер таблицы не соответствовали требованиям для автоматического выполнения. | +Создание или перестроение покрытия поиска создает поисковый столбец и индекс GIN. Это может переписать всю таблицу и удерживать блокировки, а индексированный поиск на время прерывается. Планируйте операцию на окно обслуживания. -По умолчанию Teable только записывает решения и создает записи рекомендаций и задач; он не изменяет вашу базу данных самостоятельно. Автоматическое выполнение включается по желанию через `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`, и даже тогда применяется только к небольшим таблицам, для которых план выполнения показывает явное снижение стоимости. Все остальное ожидает администратора. +Диалог возвращает подтверждение постановки задачи, а не результат. Закройте его и следите за задачей в разделе **Задачи / история**. Повторная отправка того же изменения вернет уже существующую задачу. -### Добавление предлагаемого индекса +## Управлять индексами фильтрации и сортировки -Если рекомендация предлагает индекс, с которым вы согласны, нажмите **Добавить индекс** в строке. Подтверждение принимает рекомендацию и выполняет `CREATE INDEX CONCURRENTLY` для базовой таблицы PostgreSQL; если проверка плана была пропущена, Teable все равно строит индекс на основе рекомендуемых полей. Диалог повторяет доказательства, чтобы вы могли проверить их в последний раз. +Вкладка **Индексы фильтрации / сортировки** перечисляет физические индексы, обслуживающие условия фильтрации и сортировку этой таблицы, с указанием валидности, управляется ли индекс Teable, его размера и определения. Они управляются отдельно от индексов подстрочного поиска. -Для таблицы с предполагаемым размером 50 000 строк или более диалог просит подтвердить наличие окна обслуживания, прежде чем кнопка станет доступной. Одновременное построение на большой таблице занимает время и создает нагрузку во время выполнения. +Ниже в разделе **Ожидающие действия** собраны рекомендации по индексам и отметка о том, подтверждены ли они данными плана выполнения. **Проверить создание индекса** показывает предлагаемый индекс, базу данных выполнения и доказательства; после подтверждения Teable асинхронно выполняет `CREATE INDEX CONCURRENTLY`. Для больших таблиц и таблиц неизвестного размера здесь тоже требуется подтверждение окна обслуживания. -Затем Teable сообщает либо **Индекс создан**, либо **Рекомендация принята и поставлена в очередь**. Во втором случае отслеживайте задачу на вкладке **Задачи**. Если за рекомендацией нет исполняемого физического столбца, **Добавить индекс** остается отключенной и сообщает об этом; вместо этого используйте рабочее пространство анализа для дальнейшего изучения. +Эта страница не удаляет индексы. Неуправляемые и системные индексы могут защищать ограничения или обслуживать другие запросы, поэтому их не трогают. -## Запуск углубленного анализа +## Диагностировать конкретные запросы -Откройте **Рабочее пространство анализа**, чтобы проанализировать область по запросу, например когда пользователь сообщает о медленной таблице, для которой еще нет рекомендации. +Если о медленной таблице сообщили, а подходящей рекомендации нет, откройте вкладку **Диагностика запросов** и выберите **Анализировать запросы**. Анализ только читает сохраненные формы запросов и доступные данные плана выполнения и ничего не создает. -| Тип анализа | Для чего использовать | -| --- | --- | -| **Запросы и индексы** | Поиск рисков запросов и возможных улучшений индексов. | -| **Поиск подстрок** | Проверка, может ли путь доступа для поиска подстрок ускорить поиск по вхождению без изменения его поведения сопоставления. | +Вывод бывает трех видов: **Найдены возможности индексации, подтвержденные планом**, **Доступные планы не подтверждают возможность индексации** и **Недостаточно данных**. Недостаток данных не означает, что произошло последовательное сканирование: одно наблюдение медленного запроса не доказывает, что причина в пути доступа. Ниже перечислен каждый затронутый запрос с указанием, пришел он из реального трафика или из сохраненной конфигурации представления, а также оценочная стоимость плана до и после предлагаемого индекса (стоимость плана, а не миллисекунды). -Выберите **Таблицу**, **Базу** или **Пространство**, введите соответствующий ID и выберите тип анализа. Начните с **Таблицы**, если уже знаете, какая таблица работает медленно. +## Отслеживать результаты -Нажмите **Сгенерировать отчет по запросам** или **Сгенерировать отчет по поиску**. Отчет суммирует обнаруженные риски и рекомендуемые дальнейшие действия. Для отчета по поиску **EXPLAIN-пример поиска** необязателен. Добавьте пример, чтобы проверить совместимость результатов, планы запросов и время повторных запросов для предлагаемого пути доступа для поиска подстрок. Teable не сохраняет значение примера. +Вкладка **Задачи / история** состоит из трех частей: -Отчет по запросам не изменяет базу данных. Применение рекомендации по поиску подстрок требует **EXPLAIN-примера поиска** и подтверждения администратора. +- **Задачи**: фоновые задачи этой таблицы со статусом, числом попыток, типом задачи и причиной сбоя. Если задача в итоге завершилась успешно после сбоя, ошибка помечается как прошлая попытка. +- **История настроек поиска**: поставщик, статус и список Полей каждой прошлой конфигурации покрытия. +- **История рекомендаций**: принятые, отклоненные или замененные рекомендации. -Для большой таблицы оцените влияние и запланируйте любое подтвержденное изменение на подходящее окно обслуживания. +История загружает только последние записи. Если их больше, строка над списком показывает общее число. +Пока у таблицы есть задача в очереди или в работе, кнопки настройки поиска и создания индексов остаются неактивными. Дождитесь завершения задачи. diff --git a/ru/basic/credential.mdx b/ru/basic/credential.mdx index 66cad63f..3353872f 100644 --- a/ru/basic/credential.mdx +++ b/ru/basic/credential.mdx @@ -26,7 +26,7 @@ description: Управляйте своими подключениями и с Подключение добавляется кнопкой **Подключить новый аккаунт**. Когда авторизация истекает, у подключения появляется **Переподключить**. -Для каждой записи показано, сколько ресурсов её сейчас используют. По кнопке **Посмотреть** открывается список приложений и автоматизаций, где для любого из них можно **Отозвать доступ**. +Для каждой записи показано, сколько ресурсов её сейчас используют. По кнопке **Посмотреть** открывается список приложений и автоматизаций с указанием времени выдачи доступа, где для любого из них можно **Отозвать доступ**. ## Выдача учётных данных приложению или автоматизации diff --git a/ru/basic/field/common/show-as.mdx b/ru/basic/field/common/show-as.mdx index 568485a8..37670896 100644 --- a/ru/basic/field/common/show-as.mdx +++ b/ru/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "Интерактивное отображение" -description: "Изменяйте способ отображения значений полей и поведение при нажатии, например для URL-адресов, электронной почты, телефонных номеров и числовых диаграмм." +description: "Изменяйте способ отображения значений полей и поведение при нажатии, например для электронной почты, телефонных номеров и числовых диаграмм." --- Интерактивное отображение изменяет вид значений полей и их поведение при нажатии. Оно не изменяет тип поля, а влияет только на то, как пользователи видят содержимое поля и взаимодействуют с ним. @@ -9,7 +9,6 @@ description: "Изменяйте способ отображения значе | Отображение | Описание | | --- | --- | -| URL | Отображает текст как веб-адрес. При нажатии ссылка открывается в браузере | | Электронная почта | Отображает текст как адрес электронной почты. При нажатии открывается почтовое приложение по умолчанию | | Телефон | Отображает текст как номер телефона. При нажатии запускается вызов, если устройство поддерживает эту функцию | diff --git a/ru/basic/field/long-text.mdx b/ru/basic/field/long-text.mdx index 3fee111d..00171e41 100644 --- a/ru/basic/field/long-text.mdx +++ b/ru/basic/field/long-text.mdx @@ -46,5 +46,5 @@ description: "Храните длинный текст с переносами ## Примечания -- Поле «Длинный текст» не поддерживает интерактивное отображение URL, электронной почты или телефона. Оно поддерживает только обычный текст и Markdown. -- Если содержимому не нужны переносы строк, но требуется отображение URL, электронной почты или телефона, используйте поле **Однострочный текст**. +- Веб-адреса в тексте автоматически становятся кликабельными ссылками, настраивать ничего не нужно. В развёрнутой записи кнопка рядом с полем ввода показывает все адреса, найденные в ячейке. +- Поле «Длинный текст» не поддерживает интерактивное отображение электронной почты или телефона. Если по адресу или номеру нужно нажимать, чтобы написать или позвонить, используйте поле **Однострочный текст**. diff --git a/ru/basic/field/single-line-text.mdx b/ru/basic/field/single-line-text.mdx index 3a3f6071..70adc0f8 100644 --- a/ru/basic/field/single-line-text.mdx +++ b/ru/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ description: "Храните короткий текст: имена, назва +## Автоматическое распознавание ссылок + +Веб-адреса в ячейке автоматически становятся кликабельными ссылками, настраивать ничего не нужно. Распознаются адреса, начинающиеся с `https://` или `www.`, а также распространённые домены вроде `teable.ai`. Если в значении несколько адресов, каждый становится отдельной ссылкой. В развёрнутой записи кнопка рядом с полем ввода показывает все адреса, найденные в ячейке. + +Имена файлов и номера версий, такие как `readme.md` или `v1.2.3`, за адреса не принимаются. + ## Режим отображения -Поле «Однострочный текст» поддерживает четыре режима отображения: +Поле «Однострочный текст» поддерживает три режима отображения: | Режим отображения | Для чего подходит | Действие при нажатии | | --- | --- | --- | -| По умолчанию | Имена, названия, идентификаторы и другой обычный текст | Дополнительное действие отсутствует | -| URL | Веб-адреса | Открывает URL в браузере по умолчанию | +| По умолчанию | Имена, названия, идентификаторы и другой обычный текст | Адреса становятся ссылками и открываются по нажатию | | Электронная почта | Адреса электронной почты | Открывает почтовое приложение по умолчанию | | Телефон | Номера телефонов | Открывает приложение для связи на устройстве. На мобильном устройстве пользователь может позвонить по номеру напрямую | @@ -45,7 +50,7 @@ description: "Храните короткий текст: имена, назва ## Распространённые способы использования -- **Управление контактами клиентов**: создайте поле «Сайт компании» и задайте режим **URL**, чтобы сайт открывался по нажатию. Создайте поле «Телефон» и задайте режим **Телефон**, чтобы пользователи мобильных устройств могли позвонить одним нажатием. +- **Управление контактами клиентов**: создайте поле «Сайт компании» и введите в него адрес, чтобы сайт открывался по нажатию. Создайте поле «Телефон» и задайте режим **Телефон**, чтобы пользователи мобильных устройств могли позвонить одним нажатием. - **Управление заказами или договорами**: создайте поле «Идентификатор заказа» или «Идентификатор договора» для поиска, фильтрации и сопоставления с внешними системами. - **Начальный статус обращения**: создайте поле «Текущий этап» и задайте значение по умолчанию «Новое». Если этап является частью фиксированного процесса, используйте вместо него поле **Одиночный выбор**. - **Извлечение и объединение текста**: ссылайтесь на поле «Однострочный текст» в формулах, чтобы извлекать части идентификатора, объединять отображаемые имена или нормализовать формат текста. @@ -53,5 +58,5 @@ description: "Храните короткий текст: имена, назва ## Примечания - Поле «Однострочный текст» предназначено для короткого содержимого. Клавиша Enter обычно подтверждает ввод. Для заметок, кратких содержаний статей и другого длинного содержимого используйте поле **Длинный текст**. -- URL, электронная почта и телефон — это режимы отображения. Тип поля остаётся «Однострочный текст», поэтому его по-прежнему можно сортировать, фильтровать и обрабатывать текстовыми функциями. +- Электронная почта и телефон — это режимы отображения. Тип поля остаётся «Однострочный текст», поэтому его по-прежнему можно сортировать, фильтровать и обрабатывать текстовыми функциями. - Поле «Однострочный текст» не ограничивает значения заранее заданными вариантами. Для статусов, категорий и приоритетов, где важна согласованность значений, используйте поля **Одиночный выбор** или **Множественный выбор**. diff --git a/tr/basic/admin-panel/computed-outbox.mdx b/tr/basic/admin-panel/computed-outbox.mdx index bb2fc368..e0e93c42 100644 --- a/tr/basic/admin-panel/computed-outbox.mdx +++ b/tr/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ Hesaplanan bir değer yanlış göründüğünde veya geç ulaştığında arkas | Bölüm | Yanıtladığı soru | | --- | --- | | Özet | Uçtan uca gecikme, kaynağın ne zaman değiştiği, değerin ne zaman son hâline ulaştığı ve çalışmayı hangi Tablo ve Alanların tetiklediği. **Hesaplanıyor** rozeti zincirin hâlâ çalıştığını belirtir. | -| **Zaman çizelgesi** | Çalışmanın ne zaman kuyruğa alındığı, başladığı ve tamamlandığı veya başarısız olduğu. | -| **Görev zinciri** | Basamaklı yapıdaki her görev, kendisini kuyruğa alan görevin altında iç içe gösterilir; böylece bir dalın nereden geldiğini görebilirsiniz. Her satır durumunu, plan adımlarını, **Yazma hedefini** (görevin güncellediği Tablo ve Alanlar), **Değişmiş satırları**, basamak derinliğini, kuyruğa alınma zamanını ve süresini gösterir. | +| **Zaman çizelgesi** | Yan yana üç şerit: **Uçtan uca**, kaynak değişiklikten hesaplanan yazımların yakınsamasına kadar; **Bu görev**, claim'den commit'e kadar; **Uyandırma işi** ise görevi çalıştıran uyandırmadır. Görev şeridi kuyruk beklemesi, claim / setup ve hesaplama olarak bölünür. Uyandırma işi aynı veritabanındaki diğer vadesi gelmiş işi de drain ettiğinden normalde uçtan uçadan uzun sürer. | +| **Görev zinciri** | Basamaklı yapıdaki her görev, kendisini kuyruğa alan görevin altında iç içe gösterilir; böylece bir dalın nereden geldiğini görebilirsiniz. Aynı aşamadan ayrılan kısmi gruplar seri bir kuyruktur ve daha derine iç içe girmek yerine tek düzeyde düz durur. Her satır durumunu, plan adımlarını, **Yazma hedefini** (görevin güncellediği Tablo ve Alanlar), **Tahmini karmaşıklığı**, basamak derinliğini, kuyruğa alınma zamanını ve süresini gösterir. | | **Alan yayılımı** | Çalışmanın hangi Alanları okuyup yazdığı ve değişikliğin bunlar arasında nasıl ilerlediği. Kesik mavi çizgi bu yazmaya yol açan kaynağı, gri bu çalışmada yazılmayan bir girdiyi, yeşil bu çalışmada yazılanı; oklar ise adım sırası yerine Alan bağımlılıklarını veya bağlantı geçişlerini gösterir. Yalnızca bu çalışmanın yazmalarına gerçekten ulaşan kaynaklar çizilir. Geniş bir zinciri satır içinde takip etmek zor olduğunda grafiği tam ekran açmak için **Genişlet**'i kullanın. | Köken kayıt defteri yalnızca bu özellik kullanıma sunulduktan sonra oluşturulan görevleri kaydeder ve 7 günlük geçmişi saklar. Daha eski bir görev, yayılım grafiği olmadan kuyruk bilgilerini gösterir. Worker'ın henüz planlamadığı bir başlangıç görevi yalnızca tetikleyici Alanlarını gösterir. Bir değişiklik aşağı akışta hesaplanan herhangi bir yazma üretmediyse grafik bunu belirtir: Bu Alanlara bir formül, arama, özet veya bağlantı başlığı üzerinden hiçbir şey bağlı değildir. diff --git a/tr/basic/admin-panel/overview.mdx b/tr/basic/admin-panel/overview.mdx index bef8f808..814507b2 100644 --- a/tr/basic/admin-panel/overview.mdx +++ b/tr/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ Yönetici Paneli, sayfaları amaçlarına göre gruplandırır: ### İşlemler ve denetim - **[Otomasyon yönetimi](/tr/basic/admin-panel/automation-management)**: Otomasyon çalışma durumunu ve çalışma geçmişini görüntüleyin -- **[Tablo Sorgusu İşlemleri](/tr/basic/admin-panel/table-query-ops)**: Tablo sorgusu riskini ve dizin önerilerini analiz edin +- **[Tablo Sorgusu İşlemleri](/tr/basic/admin-panel/table-query-ops)**: Tablo bazında arama kapsamını yapılandırın, dizin oluşturun ve sonuçları izleyin - **[Hesaplama Giden Kutusu](/tr/basic/admin-panel/computed-outbox)**: Hesaplama görevlerinin teslimatını, kuyruk durumunu ve veritabanı birikimini izleyin - **[AI oluşturma kuyruğu](/tr/basic/admin-panel/ai-generation-queue)**: Mevcut kendi sunucunuzda barındırılan örnekte AI Alanı oluşturma durumunu inceleyin - **[Korumalı Alan Aracısı](/tr/basic/admin-panel/sandbox-agent)**: Korumalı Alan Aracısını yapılandırın ve yönetin diff --git a/tr/basic/admin-panel/table-query-ops.mdx b/tr/basic/admin-panel/table-query-ops.mdx index 43076431..20aa44de 100644 --- a/tr/basic/admin-panel/table-query-ops.mdx +++ b/tr/basic/admin-panel/table-query-ops.mdx @@ -1,85 +1,74 @@ --- title: "Tablo Sorgusu İşlemleri" -description: "Yavaş Tablolara yönelik sorgu riski önerilerini inceleyin ve veritabanı iyileştirmelerini onaylayın." +description: "Arama kapsamını ve dizinleri Tablo bazında inceleyin, aramayı yapılandırın, dizin oluşturun ve sonuçları izleyin." --- Kendi sunucunuzda barındırılan Business ve üzeri planlarda kullanılabilir Yol: Yönetici Paneli → Tablo Sorgusu İşlemleri -Büyük bir Tablodaki Görünümler, filtreler, ilişkiler veya aramalar yavaşladığında **Tablo Sorgusu İşlemlerini** kullanın. Arka plan analiz aracı sorgu iş yükünü izler ve gözlemlerini önerilere dönüştürür. Sayfa bu önerileri listeler; böylece örnek yöneticileri kanıtları inceleyebilir, belirli bir Tabloyu daha ayrıntılı analiz edebilir ve veritabanında yapılacak değişiklikleri onaylayabilir. +Büyük bir Tablodaki Görünümler, filtreler, ilişkiler veya aramalar yavaşladığında **Tablo araması ve dizinleri** bölümünü kullanın. Teable sorgu iş yükünü arka planda izler ve her Tabloyu özetler: şu anda nasıl arandığı, hangi Alanların kapsandığı, hangi fiziksel dizinlerin bulunduğu ve son dönemde kaç yavaş sorgu görüldüğü. Örnek yöneticileri arama kapsamını burada yapılandırır, dizin oluşturur ve sonuçları izler. -Listenin üzerindeki sayaçlar mevcut durumu özetler: gözlem aralıkları, istekler, yavaş sorgular, zaman aşımları, açık ve kabul edilmiş öneriler, devam eden ve başarısız görevler ile hazır veya performansı düşmüş arama erişim yollarının sayısı. +Sayfa yalnızca görev kuyruğa alır; veritabanını hiçbir zaman doğrudan değiştirmez. Her değişiklik arka planda eşzamansız çalışır, bu yüzden sonucu **Görevler / geçmiş** bölümünden doğrulayın. -## Önerileri İnceleme +## Üzerinde çalışılacak Tabloyu bulma -Sayfa, önceliğe göre sıralanmış **Öneriler** sekmesinde açılır. Analiz aracı bir sorgunun riskini Tablonun kullanım yoğunluğuyla birlikte değerlendirir; böylece işlem yapılması en faydalı girdiler ilk sırada gösterilir. +Sayfa Tablo listesiyle açılır. Üstteki durum düğmeleri kendi sayılarını taşır ve listeyi daraltır: -Tüm önerileri filtrelemek için Tablo, Veritabanı veya Alan kimliğiyle arama yapın; diğer metinler yalnızca ekranda bulunanları filtreler. Durum ve risk filtreleri listeyi daha da daraltır. - -Her girdi ait olduğu Alanı, Veritabanını ve Tabloyu belirtir. Önerinin arkasındaki kanıtları, sistem kararını ve SQL tanılama bilgilerini okumak için bir satırı genişletin: - -| Bölüm | Verdiği bilgiler | +| Durum | Anlamı | | --- | --- | -| **Tetikleyici** | Önerinin kaynağı: gözlemlenen sorgu trafiği, kaydedilmiş bir Görünüm yapılandırması veya ilişki Alanı yapılandırması. Kaydedilmiş Görünüm tetikleyicisi, henüz yavaş bir sorgu gözlemlenmediği ve riski yalnızca yapılandırmanın ortaya çıkardığı anlamına gelir. | -| **Erişim yolu** | Bu Tabloya sıralı tarama ve dizin taramasıyla ne sıklıkta erişildiği. | -| **Nedenler** | Büyük Tablo, filtre veya sıralama Alanlarında kullanışlı bir dizinin bulunmaması, maliyetli sıralama veya gözlemlenen zaman aşımları gibi okunabilir nedenler. | -| **Sorgu yapısı** | Her birinin kullandığı eşleşme türüyle birlikte filtrelenen ve sıralanan belirli Alanlar. | -| **Önerilen dizin** | Önerinin dizine ekleyeceği Alanlar ve nedeni. | +| **Tüm tablolar** | Gözlemlenen bütün Tablolar. | +| **Dikkat gerektiriyor** | Yavaş sorgusu, zaman aşımı, bekleyen önerisi veya başarısız görevi olan Tablolar. Buradan başlayın. | +| **Dizinli arama** | Arama kapsamı zaten yapılandırılmış Tablolar. | +| **Yapılandırılmamış** | Henüz arama kapsamı olmayan Tablolar. | +| **Kullanılamıyor** | Şu anda dizinli aramayı kullanamayan Tablolar. Satırda nedeni yazar. | -**Derin analiz**, ilgili Tablo önceden doldurulmuş olarak analiz çalışma alanını açar. +Arama kutusu Tablo, Veritabanı ve Alan adlarını veya kimliklerini kabul eder. Sıralama **En çok yavaş sorgu** ya da **Tablo adı** şeklindedir. **Gözlem penceresi** son 1 saati, 24 saati veya 7 günü kapsar ve listedeki tüm gözlem değerleri bu pencereyi izler. -Analiz aracı bir Tablonun tamamında yoğun alt dize araması algıladığında Alan başına dizin yerine tüm Tablo için tek bir **oluşturulmuş metin GIN** önerisi sunar. Böyle bir satırda **Derin analiz** yerine **Arama yolu oluştur** seçeneği bulunur. **Dizin ekle** ise gösterilmez. Tablo bu yola sahip olduğunda öneri kendiliğinden kapanır. +Her satırda Tablonun tahmini satır sayısı ve boyutu, pencere içindeki istekler ve yavaş sorgular, geçerli arama yöntemi ve Alan kapsamı, filtre/sıralama dizinlerinin sayısı, bekleyen öneriler ile etkin görevlerin sayısı yer alır. Ayrıntı için Tablo adına tıklayın. -**Arama yolu oluştur**, sayfadan çıkmadan tablo için bir deneme çalıştırması (dry run) yapan bir pencere açar. Pencerede adayın dizin sağlayıcısı, kapsanan alan sayısı, tahmini satır sayısı ve öncesi ile sonrası `EXPLAIN` maliyeti görünür. Pencerede belirtilen en az uzunlukta bir örnek arama terimi girin; bu terim yalnızca doğrulama için kullanılır ve saklanmaz. Büyük tablolarda bakım penceresi onay kutusunu da işaretleyin. Onayladığınızda Teable adayı yeniden doğrular ve arama yolunu etkinleştirir. +## Arama kapsamını yapılandırma -Analiz hiçbir aday üretmezse pencere nedenini açıklar ve hiçbir işlem yapmaz. Geniş tablolar reddedilir, çünkü Teable bunlar için tüm alanları kapsayan bir arama belgesi oluşturmaz; daha uzun bir arama terimi de bunu değiştirmez. Bu durumda **Seçili alanları analiz et**’e tıklayıp analiz çalışma alanında yalnızca kullanıcıların gerçekten aradığı alanları inceleyin. +**Arama kapsamı** sekmesi Tablonun geçerli arama yöntemini, kapsanan Alan sayısını ve her Alanın kapsam durumunu gösterir. **Kapsanmayan alanları göster**, listeyi henüz dahil edilmemiş Alanlara indirger; **Uygun değil** olarak işaretlenen Alanlar alt dize arama dizinine katkı veremez. -Yanında iki sekme daha bulunur: +Kapsam açıkça belirlenir. Sonradan eklediğiniz Alanlar otomatik olarak dahil edilmez; bunları katmak için Tabloyu yeniden yapılandırın. Kapsam dışındaki aramalar veya çok kısa arama terimleri daha yavaş bir `ILIKE` taramasına geri döner. -| Sekme | Gösterdiği bilgiler | -| --- | --- | -| **Yoğun Tablolar** | İstekler, yavaş sorgular, zaman aşımları ve en uzun sorgu süreleriyle birlikte en yoğun Tablolar. | -| **Görevler** | Teable'ın oluşturduğu düzeltme görevleri; durum, denemeler, worker ve son hata bilgileriyle birlikte. | +Hiç yapılandırılmamış bir Tabloda **Aramayı yapılandır**, yapılandırılmış bir Tabloda **Seçimi güncelle / yeniden oluştur** seçeneğini kullanın. İletişim kutusu şunları ister: -Bir yapılandırma sorunu süreci engellediğinde listenin üzerinde bir başlık şeridi görünür: Çalışma zamanı bayrağı kapalıyken arama erişim yolları yapılandırılmış olabilir, bazı Tablolardaki erişim yolu güncelliğini yitirmiş veya yeniden oluşturulmayı bekliyor olabilir ve aramaları sessizce daha yavaş `ILIKE` taramasına dönmüş olabilir ya da kuyruktaki en eski görev, hiçbir worker'ın onu işlemediğini düşündürecek kadar uzun süredir bekliyor olabilir. Aşağıdaki öneriler üzerinde işlem yapmadan önce başlık şeridinde bildirilen sorunu düzeltin. +| Öğe | Ne gireceğiniz | +| --- | --- | +| **Arama sağlayıcısı** | `pg_bigm` veya `pg_trgm`. Uzantı eksikse iletişim kutusu neyin eksik olduğunu ve kimin kurabileceğini yazar. | +| **Temsili arama metni** | Kullanıcılarınızın gerçekten arayacağı bir metin. Alt dize semantiğini denetler ve plan kanıtı toplar; hiçbir zaman kaydedilmez. Çok kısaysa iletişim kutusu gereken en az uzunluğu belirtir. | +| **Alanlar** | Kullanıcıların gerçekten aradığı Alanları seçin. Geniş bir Tabloda hepsini seçmeyin; her Alan için arama belgesi oluşturmak pahalıdır. | -### Karar Rozetini Okuma +**Analiz et ve prova çalıştır**, değişikliği işlemeden yürütür ve kapsanan Alan sayısını, tahmini satır sayısını, plan kanıtının olup olmadığını, oluşturma veya yeniden oluşturmanın etkisini bildirir. Tahminen 50.000 satır ve üzeri ya da boyutu bilinmeyen Tablolarda ayrıca bakım penceresi onayı gerekir. Ardından **Onayla ve görevi kuyruğa al** seçeneğini kullanın. -Her öneride sistemin öneri hakkında verdiği en son karar bulunur: +Arama kapsamını oluşturmak veya yeniden oluşturmak bir arama sütunu ile GIN dizini üretir. Tablonun tamamını yeniden yazabilir, kilit tutabilir ve çalışırken dizinli arama kısa süre kesilir. Bunu bir bakım penceresine planlayın. -| Rozet | Anlamı | -| --- | --- | -| **Elle onay gerekiyor** | Bunu yalnızca bir yönetici uygulayabilir. | -| **Gölge · otomatik çalıştırılabilirdi** | Öneri kabul ölçütlerini karşılıyor ancak otomatik yürütme etkinleştirilmediğinden hiçbir şey değişmedi. | -| **Otomatik yürütülüyor** / **Otomatik yürütüldü** | Otomatik yürütme öneriyi kabul edip uyguladı. | -| **Son doğrulama başarısız · bekleme süresi artıyor** | Otomatik değişiklik doğrulamadan geçmedi. Teable bu Tabloyu yeniden denemeden önce daha uzun süre bekler. | -| **Bekleme döneminde** | Aynı kapsam kısa süre önce değiştirildiğinden sistem bekliyor. | -| **Beklemede** / **Otomatik yürütme uygulanmadı** | Plan kanıtları veya Tablo boyutu otomatik yürütme eşiğini karşılamadı. | +İletişim kutusunun döndürdüğü şey görev makbuzudur, sonuç değil. Kutuyu kapatın ve görevi **Görevler / geçmiş** bölümünden izleyin. Aynı değişikliği yeniden gönderdiğinizde var olan görev döner. -Teable varsayılan olarak yalnızca kararları kaydeder ve öneri ile görev Kayıtları oluşturur; veritabanınızı kendiliğinden değiştirmez. Otomatik yürütme `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto` aracılığıyla isteğe bağlı olarak etkinleştirilir ve bu durumda bile yalnızca yürütme planında belirgin bir maliyet iyileşmesi görülen küçük Tablolara uygulanır. Diğer tüm işlemler bir yöneticiyi bekler. +## Filtre ve sıralama dizinlerini yönetme -### Önerilen Dizini Ekleme +**Filtre / sıralama dizinleri** sekmesi, bu Tablodaki filtre koşullarına ve sıralamalara hizmet eden fiziksel dizinleri geçerlilik, Teable tarafından yönetilip yönetilmediği, boyut ve tanım bilgileriyle listeler. Bunlar alt dize arama dizinlerinden ayrı yönetilir. -Bir öneride kabul ettiğiniz bir dizin sunulduğunda satırdaki **Dizin ekle** seçeneğine tıklayın. Onaylama, öneriyi kabul edip temel PostgreSQL Tablosunda `CREATE INDEX CONCURRENTLY` komutunu çalıştırır; plan doğrulaması atlanmışsa Teable yine de önerilen Alanlardan dizini oluşturur. İletişim kutusu, son kez kontrol edebilmeniz için kanıtları tekrar gösterir. +Altındaki **Bekleyen işlemler**, sistemin dizin önerilerini tutar ve her birinin plan kanıtıyla desteklenip desteklenmediğini belirtir. **Dizin oluşturmayı incele**, önerilen dizini, çalıştırılacağı veritabanını ve kanıtları gösterir; onayınızın ardından Teable `CREATE INDEX CONCURRENTLY` komutunu eşzamansız çalıştırır. Büyük ve boyutu bilinmeyen Tablolarda burada da bakım penceresi onayı gerekir. -50.000 veya daha fazla satır içerdiği tahmin edilen Tablolarda iletişim kutusu, düğme kullanılabilir olmadan önce bir bakım aralığının planlandığını onaylamanızı ister. Büyük bir Tabloda eş zamanlı derleme zaman alır ve çalışırken ek yük oluşturur. +Bu sayfa dizin silmez. Yönetilmeyen ve sistem dizinleri kısıtları koruyor ya da başka iş yüklerine hizmet ediyor olabilir, bu yüzden onlara dokunulmaz. -Teable daha sonra **Dizin oluşturuldu** veya **Öneri kabul edildi ve kuyruğa alındı** sonucunu bildirir. İkinci durumda görevi **Görevler** bölümünden takip edin. Önerinin arkasında yürütülebilir bir fiziksel sütun yoksa **Dizin ekle** devre dışı kalır ve nedeni gösterir; bunun yerine analiz çalışma alanını kullanarak daha ayrıntılı inceleyin. +## Belirli sorguları tanılama -## Derin Analiz Çalıştırma +Bir Tablo yavaş olarak bildirildiğinde ve bunu karşılayan bir öneri yoksa **Sorgu tanılama** sekmesini açıp **Sorguları analiz et** seçeneğini kullanın. Analiz yalnızca kayıtlı sorgu biçimlerini ve mevcut plan kanıtlarını okur; hiçbir şey oluşturmaz. -Örneğin bir kullanıcı henüz önerisi bulunmayan yavaş bir Tablo bildirdiğinde, isteğe bağlı olarak bir kapsamı analiz etmek için **Analiz çalışma alanını** açın. +Sonuç şunlardan biridir: **Planla desteklenen dizin fırsatları bulundu**, **Mevcut planlar bir dizin fırsatını doğrulamıyor** veya **Yetersiz kanıt**. Yetersiz kanıt, sıralı tarama yapıldığı anlamına gelmez; tek başına yavaş bir gözlem, erişim yolunun sorumlu olduğunu göstermez. Altta, etkilenen her sorgu gerçek trafikten mi yoksa kayıtlı bir Görünüm yapılandırmasından mı geldiğiyle ve önerilen dizin öncesi ile sonrası tahmini plan maliyetiyle (milisaniye değil, plan maliyeti) listelenir. -| Analiz türü | Kullanım amacı | -| --- | --- | -| **Sorgular ve dizinler** | Sorgu risklerini ve olası dizin iyileştirmelerini bulma. | -| **Alt dize araması** | Alt dize araması erişim yolunun, eşleşme davranışını değiştirmeden içerir aramalarını hızlandırıp hızlandıramayacağını kontrol etme. | +## Sonuçları izleme -**Tablo**, **Veritabanı** veya **Alan** seçeneğini belirleyin, karşılık gelen kimliği girin ve bir analiz türü seçin. Hangi Tablonun yavaş olduğunu zaten biliyorsanız **Tablo** ile başlayın. +**Görevler / geçmiş** sekmesi üç bölümden oluşur: -**Sorgu raporu oluştur** veya **Arama raporu oluştur** seçeneğine tıklayın. Rapor, tespit edilen riskleri ve önerilen sonraki eylemleri özetler. Arama raporunda **EXPLAIN örnek araması** isteğe bağlıdır. Önerilen alt dize araması erişim yolunun sonuç uyumluluğunu, sorgu planlarını ve yinelenen sorgu zamanlamasını kontrol etmek için bir örnek ekleyin. Teable örnek değeri kaydetmez. +- **Görevler**: bu Tablonun arka plan görevleri; durum, deneme sayısı, görev türü ve hata nedeniyle birlikte. Bir görev başarısızlıktan sonra sonunda başarılı olduysa hata, önceki deneme olarak işaretlenir. +- **Arama yapılandırması geçmişi**: geçmiş kapsam yapılandırmalarının sağlayıcısı, durumu ve Alan listesi. +- **Öneri geçmişi**: kabul edilen, yok sayılan veya yerini başkasına bırakan öneriler. -Sorgu raporu veritabanını değiştirmez. Bir alt dize araması önerisini uygulamak için **EXPLAIN örnek araması** ve yönetici onayı gerekir. +Geçmiş yalnızca en yeni kayıtları yükler. Daha fazlası varsa listenin üstündeki satır toplam sayıyı verir. -Büyük bir Tablo için etkiyi inceleyin ve onaylanan değişiklikleri uygun bir bakım aralığına zamanlayın. +Bir Tabloda kuyruğa alınmış veya çalışan bir görev varken, aramayı yapılandırma ve dizin oluşturma düğmeleri devre dışı kalır. Görevin bitmesini bekleyin. diff --git a/tr/basic/credential.mdx b/tr/basic/credential.mdx index 735acb4c..6ac08dcd 100644 --- a/tr/basic/credential.mdx +++ b/tr/basic/credential.mdx @@ -26,7 +26,7 @@ Sol alttaki avatarınıza tıklayıp **Ayarlar** → **Entegrasyonlar** bölüm Bağlantılar **Yeni hesap bağla** ile eklenir. Bir yetkilendirme sona erdiğinde ilgili bağlantıda **Yeniden bağla** görünür. -Her kimlik bilgisinin altında şu anda kaç kaynağın onu kullandığı yazar. **Görüntüle**, uygulama ve otomasyonların listesini açar; buradan tek bir kayıt için **Yetkiyi kaldır** diyebilirsiniz. +Her kimlik bilgisinin altında şu anda kaç kaynağın onu kullandığı yazar. **Görüntüle**, her biri yetkinin ne zaman verildiğiyle birlikte uygulama ve otomasyonların listesini açar; buradan tek bir kayıt için **Yetkiyi kaldır** diyebilirsiniz. ## Bir uygulamaya veya otomasyona erişim verme diff --git a/tr/basic/field/common/show-as.mdx b/tr/basic/field/common/show-as.mdx index 33b74e78..04186e08 100644 --- a/tr/basic/field/common/show-as.mdx +++ b/tr/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "Etkileşimli Görüntüleme" -description: "URL'ler, e-postalar, telefon numaraları ve sayı grafikleri gibi alan değerlerinin görüntülenmesini ve tıklama davranışını değiştirin." +description: "E-postalar, telefon numaraları ve sayı grafikleri gibi alan değerlerinin görüntülenmesini ve tıklama davranışını değiştirin." --- Etkileşimli görüntüleme, alan değerlerinin nasıl göründüğünü ve tıklandığında nasıl davrandığını değiştirir. Alan türünü değiştirmez. Yalnızca kullanıcıların alan içeriğini nasıl görüntüleyip onunla etkileşim kurduğunu değiştirir. @@ -9,7 +9,6 @@ Etkileşimli görüntüleme, alan değerlerinin nasıl göründüğünü ve tık | Görüntüleme | Açıklama | | --- | --- | -| URL | Metni web adresi olarak gösterir. Tıklandığında bağlantıyı tarayıcıda açar | | E-posta | Metni e-posta adresi olarak gösterir. Tıklandığında varsayılan posta uygulamasını açar | | Telefon | Metni telefon numarası olarak gösterir. Tıklandığında, cihaz desteğine bağlı olarak arama eylemini başlatır | diff --git a/tr/basic/field/long-text.mdx b/tr/basic/field/long-text.mdx index 79748900..67f00181 100644 --- a/tr/basic/field/long-text.mdx +++ b/tr/basic/field/long-text.mdx @@ -46,5 +46,5 @@ description: "Düz metin ve Markdown görüntüleme desteğiyle, satır sonları ## Notlar -- Uzun Metin; URL, E-posta veya Telefon etkileşimli görüntülemesini desteklemez. Yalnızca düz metni ve Markdown'ı destekler. -- İçerik satır sonu gerektirmiyorsa ve URL, E-posta veya Telefon görünümünü kullanacaksa **Tek Satır Metin** alanını kullanın. +- Metindeki web adresleri, hiçbir ayar yapmadan tıklanabilir bağlantılara dönüşür. Kaydı genişlettiğinizde, giriş alanının yanındaki bağlantı düğmesi hücredeki tüm adresleri listeler. +- Uzun Metin, E-posta veya Telefon etkileşimli görüntülemesini desteklemez. Bir adrese ya da numaraya tıklayıp yazmak veya aramak istiyorsanız **Tek Satır Metin** alanını kullanın. diff --git a/tr/basic/field/single-line-text.mdx b/tr/basic/field/single-line-text.mdx index 946a96f1..8bc411f6 100644 --- a/tr/basic/field/single-line-text.mdx +++ b/tr/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ Satır sonu gerektiren notlar, özetler veya açıklamalar için **[Uzun Metin]( +## Otomatik Bağlantı Algılama + +Hücredeki web adresleri, hiçbir ayar yapmadan tıklanabilir bağlantılara dönüşür. `https://` veya `www.` ile başlayan adreslerin yanı sıra `teable.ai` gibi yaygın alan adları da tanınır. Bir değerde birden fazla adres varsa her biri ayrı bir bağlantı olur. Kaydı genişlettiğinizde, giriş alanının yanındaki bağlantı düğmesi hücredeki tüm adresleri listeler. + +`readme.md` veya `v1.2.3` gibi dosya adları ve sürüm numaraları adres sanılmaz. + ## Görüntüleme Modu -Tek Satır Metin dört görüntüleme modunu destekler: +Tek Satır Metin üç görüntüleme modunu destekler: | Görüntüleme modu | Uygun olduğu durumlar | Tıklama davranışı | | --- | --- | --- | -| Varsayılan | Adlar, başlıklar, kimlikler ve diğer düz metinler | Ek bir tıklama davranışı yoktur | -| URL | Web adresleri | URL'yi varsayılan tarayıcıda açar | +| Varsayılan | Adlar, başlıklar, kimlikler ve diğer düz metinler | Adresler bağlantıya dönüşür ve tıklandığında açılır | | E-posta | E-posta adresleri | Varsayılan e-posta uygulamasını açar | | Telefon | Telefon numaraları | Cihazdaki iletişim uygulamasını açar. Mobil cihazlarda kullanıcılar numarayı doğrudan arayabilir | @@ -45,7 +50,7 @@ Görüntüleme modu, değerin görünümünü ve tıklandığındaki davranış ## Yaygın Kullanımlar -- **Müşteri iletişim bilgileri yönetimi**: Bir "Şirket Web Sitesi" alanı oluşturun ve tıklandığında web sitesinin açılması için **URL** olarak ayarlayın. Mobil kullanıcıların tek dokunuşla arayabilmesi için bir "Telefon" alanı oluşturun ve **Telefon** olarak ayarlayın. +- **Müşteri iletişim bilgileri yönetimi**: Bir "Şirket Web Sitesi" alanı oluşturup adresi yazın; tıklandığında web sitesi açılır. Mobil kullanıcıların tek dokunuşla arayabilmesi için bir "Telefon" alanı oluşturun ve **Telefon** olarak ayarlayın. - **Sipariş veya sözleşme yönetimi**: Arama, filtreleme ve harici sistemlerle eşleştirme için bir "Sipariş Kimliği" veya "Sözleşme Kimliği" alanı oluşturun. - **İlk destek kaydı durumu**: Bir "Geçerli Aşama" alanı oluşturun ve varsayılan değeri "Yeni" olarak ayarlayın. Aşama sabit bir iş akışından geliyorsa bunun yerine **Tekli Seçim** alanını kullanın. - **Metin ayıklama ve birleştirme**: Kimlik bölümlerini ayıklamak, görünen adları birleştirmek veya metin biçimini normalleştirmek için formüllerde Tek Satır Metin alanına başvurun. @@ -53,5 +58,5 @@ Görüntüleme modu, değerin görünümünü ve tıklandığındaki davranış ## Notlar - Tek Satır Metin kısa içerikler içindir. Enter tuşu genellikle girişi onaylar. Notlar, makale özetleri ve diğer uzun içerikler için **Uzun Metin** alanını kullanın. -- URL, E-posta ve Telefon görüntüleme modlarıdır. Alan, Tek Satır Metin olarak kalır ve sıralanmaya, filtrelenmeye ve metin işlevleriyle işlenmeye devam edebilir. +- E-posta ve Telefon görüntüleme modlarıdır. Alan, Tek Satır Metin olarak kalır ve sıralanmaya, filtrelenmeye ve metin işlevleriyle işlenmeye devam edebilir. - Tek Satır Metin, değerleri önceden tanımlanmış seçeneklerle sınırlamaz. Tutarlı değerler gerektiren durumlar, kategoriler ve öncelikler için **Tekli Seçim** veya **Çoklu Seçim** alanını kullanın. diff --git a/uk/basic/admin-panel/computed-outbox.mdx b/uk/basic/admin-panel/computed-outbox.mdx index 08cd7df5..e7a847c5 100644 --- a/uk/basic/admin-panel/computed-outbox.mdx +++ b/uk/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ description: "Відстежуйте доставлення BullMQ і чергу | Розділ | На яке запитання відповідає | | --- | --- | | Зведення | Загальна затримка, час зміни джерела й узгодження значення, а також Таблиця та Поля, що ініціювали запуск. Позначка **Обчислення** означає, що ланцюжок іще виконується. | -| **Часова шкала** | Коли запуск було додано до черги, розпочато та завершено або коли він завершився помилкою. | -| **Ланцюжок завдань** | Кожне завдання в каскаді, вкладене під завданням, яке додало його до черги, щоб було видно джерело кожної гілки. У кожному рядку відображається стан, кроки плану, **Ціль запису** (Таблиця й Поля, які оновлює завдання), **Змінені рядки**, глибина каскаду, час додавання до черги й тривалість. | +| **Часова шкала** | Три доріжки поруч: **Наскрізна** триває від зміни джерела до збіжності обчислюваних записів, **Цей task** від claim до commit, а **Wakeup-job** це те пробудження, яке його виконало. Доріжку завдання поділено на очікування в черзі, claim / setup і обчислення. Wakeup-job принагідно добирає прострочену роботу тієї ж БД, тож зазвичай триває довше за наскрізну. | +| **Ланцюжок завдань** | Кожне завдання в каскаді, вкладене під завданням, яке додало його до черги, щоб було видно джерело кожної гілки. Часткові партії, відокремлені від одного етапу, є послідовною чергою й лишаються на одному рівні, а не вкладаються глибше. У кожному рядку відображається стан, кроки плану, **Ціль запису** (Таблиця й Поля, які оновлює завдання), **Оцінка складності**, глибина каскаду, час додавання до черги й тривалість. | | **Поширення Полів** | Які Поля прочитав і записав запуск та як зміна поширювалася між ними. Синій пунктир позначає джерело, що призвело до цього запису; сірий — вхідне значення, яке не було записано під час цього запуску; зелений — значення, записане під час цього запуску; стрілки показують залежності Полів або переходи за зв’язками, а не порядок кроків. Відображаються лише джерела, які справді досягають операцій запису цього запуску. Натисніть **Розгорнути**, щоб відкрити графік на весь екран, якщо широкий ланцюжок складно переглядати вбудованим. | Реєстр ланцюжків записує лише завдання, створені після появи цієї функції, і зберігає історію протягом 7 днів. Для старішого завдання відображаються відомості черги без графіка поширення. Для початкового завдання, яке виконавець іще не спланував, показано лише Поля-тригери. Якщо зміна не спричинила подальших операцій запису обчислених значень, графік повідомляє про це: жодне значення не залежало від цих Полів через формулу, пошук, агрегацію або назву зв’язку. diff --git a/uk/basic/admin-panel/overview.mdx b/uk/basic/admin-panel/overview.mdx index e353f77b..81f70362 100644 --- a/uk/basic/admin-panel/overview.mdx +++ b/uk/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ description: "Панель адміністратора в самостійно ### Операції та аудит - **[Керування автоматизаціями](/uk/basic/admin-panel/automation-management)**: перегляд стану та історії запусків автоматизацій -- **[Операції із запитами до Таблиць](/uk/basic/admin-panel/table-query-ops)**: аналіз ризиків запитів і рекомендацій щодо індексів +- **[Операції із запитами до Таблиць](/uk/basic/admin-panel/table-query-ops)**: налаштування покриття пошуку для таблиць, створення індексів і відстеження результатів - **[Черга обчислень](/uk/basic/admin-panel/computed-outbox)**: моніторинг доставлення обчислювальних завдань, стану черги та невиконаних завдань бази даних - **[Черга генерації ШІ](/uk/basic/admin-panel/ai-generation-queue)**: перегляд стану генерації Полів ШІ в поточному самостійно розгорнутому екземплярі - **[Sandbox Agent](/uk/basic/admin-panel/sandbox-agent)**: налаштування Sandbox Agent і керування ним diff --git a/uk/basic/admin-panel/table-query-ops.mdx b/uk/basic/admin-panel/table-query-ops.mdx index e9b1b6ad..6c0af8e9 100644 --- a/uk/basic/admin-panel/table-query-ops.mdx +++ b/uk/basic/admin-panel/table-query-ops.mdx @@ -1,85 +1,74 @@ --- title: "Операції із запитами до Таблиць" -description: "Переглядайте рекомендації щодо ризиків запитів для повільних Таблиць і підтверджуйте вдосконалення бази даних." +description: "Переглядайте покриття пошуку та індекси для кожної Таблиці, налаштовуйте пошук, створюйте індекси й відстежуйте результати." --- Доступно для самостійно розгорнутого тарифного плану Business та вище Шлях: Панель адміністратора → Операції із запитами до Таблиць -Використовуйте розділ **Операції із запитами до Таблиць**, коли Перегляди, фільтри, зв’язки або пошук у великій Таблиці сповільнюються. Фоновий аналізатор стежить за навантаженням запитів і перетворює спостереження на рекомендації. Вони відображаються на сторінці, щоб адміністратори екземпляра могли перевірити докази, докладніше проаналізувати певну Таблицю й підтвердити будь-яку зміну бази даних. +Використовуйте розділ **Пошук та індекси Таблиць**, коли Перегляди, фільтри, зв’язки або пошук у великій Таблиці сповільнюються. Teable у фоні стежить за навантаженням запитів і зводить стан кожної Таблиці: як у ній зараз виконується пошук, які Поля охоплено, які фізичні індекси є та скільки повільних запитів зафіксовано нещодавно. Адміністратори екземпляра тут налаштовують покриття пошуку, створюють індекси й відстежують результати. -Лічильники над списком підсумовують поточний стан: вікна спостереження, запити, повільні запити, перевищення часу очікування, відкриті та прийняті рекомендації, активні й невдалі завдання, а також кількість готових або погіршених шляхів доступу для пошуку. +Сторінка лише додає завдання до черги й ніколи не змінює базу даних напряму. Кожна зміна виконується у фоні асинхронно, тож перевіряйте підсумок у розділі **Завдання / історія**. -## Перегляд рекомендацій +## Знайти потрібну Таблицю -Сторінка відкривається на вкладці **Рекомендації**, упорядкованій за пріоритетом. Аналізатор зіставляє ризик запиту з інтенсивністю використання Таблиці, тому першими відображаються рекомендації, на які найважливіше відреагувати. +Сторінка відкривається зі списком Таблиць. Кнопки станів угорі мають власні лічильники й звужують список: -Шукайте за ідентифікатором Таблиці, Бази або Простору, щоб фільтрувати всі рекомендації; будь-який інший текст фільтрує вміст, який уже відображається. Фільтри стану й ризику додатково звужують список. - -Для кожного елемента вказано Простір, Базу й Таблицю, до яких він належить. Розгорніть рядок, щоб переглянути докази, на яких ґрунтується рекомендація, рішення системи й діагностику SQL: - -| Розділ | Що він повідомляє | +| Стан | Що означає | | --- | --- | -| **Тригер** | Джерело рекомендації: спостережуваний трафік запитів, збережена конфігурація Перегляду або конфігурація Поля зв’язку. Тригер збереженого Перегляду означає, що повільний запит іще не спостерігався: ризик виник через саму конфігурацію. | -| **Шлях доступу** | Як часто ця Таблиця читалася послідовним скануванням і скануванням індексу. | -| **Причини** | Зрозумілі причини, наприклад велика Таблиця, відсутність корисного індексу для Полів фільтрування чи сортування, ресурсомістке сортування або зафіксоване перевищення часу очікування. | -| **Форма запиту** | Конкретні Поля, за якими виконується фільтрування й сортування, і тип зіставлення для кожного з них. | -| **Запропонований індекс** | Поля, які буде індексовано за рекомендацією, і причина. | +| **Усі Таблиці** | Усі спостережувані Таблиці. | +| **Потребують уваги** | Таблиці з повільними запитами, тайм-аутами, відкритими рекомендаціями або невдалими завданнями. Починайте звідси. | +| **Індексований пошук** | Таблиці, для яких покриття пошуку вже налаштовано. | +| **Не налаштовано** | Таблиці без покриття пошуку. | +| **Недоступно** | Таблиці, які зараз не можуть використовувати індексований пошук. Причину вказано в рядку. | -Команда **Глибокий аналіз** відкриває робочу область аналізу з уже вибраною Таблицею. +Поле пошуку приймає назви та ідентифікатори Таблиць, Баз і Просторів. Сортувати можна за параметром **Найбільше повільних запитів** або **Назва Таблиці**. **Вікно спостереження** охоплює останню годину, 24 години або 7 днів, і всі показники спостережень у списку відповідають цьому вікну. -Якщо аналізатор виявляє інтенсивний пошук підрядків у всій Таблиці, він створює одну рекомендацію **GIN для згенерованого тексту** для всієї Таблиці замість окремого індексу для кожного Поля. У такому рядку замість **Глибокого аналізу** доступна команда **Створити шлях пошуку**, а команда **Додати індекс** не відображається. Рекомендація автоматично закриється, коли Таблиця отримає цей шлях. +У кожному рядку наведено оцінену кількість рядків і розмір Таблиці, запити й повільні запити за вікно, поточний метод пошуку та покриття Полів, кількість індексів фільтрування/сортування, а також кількість відкритих рекомендацій і активних завдань. Натисніть назву Таблиці, щоб відкрити подробиці. -**Створити шлях пошуку** відкриває вікно, яке виконує пробний запуск (dry run) для Таблиці просто на цій сторінці. У вікні показано постачальника індексу для кандидата, кількість охоплених Полів, оцінку рядків і вартість `EXPLAIN` до та після. Введіть приклад пошукового запиту завдовжки не менше вказаного мінімуму: він потрібен лише для перевірки й не зберігається. Для великої Таблиці додатково позначте прапорець про вікно обслуговування. Після підтвердження Teable ще раз перевіряє кандидата й вмикає шлях пошуку. +## Налаштувати покриття пошуку -Якщо аналіз не дає кандидата, вікно пояснює причину й нічого не виконує. Широку Таблицю буде відхилено, бо Teable не створює для неї пошуковий документ за всіма Полями, і довший запит цього не змінить. Тоді натисніть **Проаналізувати вибрані Поля**, щоб у робочій області аналізу опрацювати лише ті Поля, за якими справді шукають. +Вкладка **Покриття пошуку** показує поточний метод пошуку Таблиці, кількість охоплених Полів і стан покриття кожного Поля. **Показати неохоплені поля** залишає у списку лише ще не включені Поля; Поля з позначкою **Не підходить** не можуть брати участь в індексі підрядкового пошуку. -Поруч розташовано ще дві вкладки: +Покриття задається явно. Поля, додані згодом, не включаються автоматично: налаштуйте Таблицю ще раз, щоб їх урахувати. Пошук поза межами покриття, а також надто короткий запит, повертається до повільнішого сканування `ILIKE`. -| Вкладка | Що вона показує | -| --- | --- | -| **Навантажені Таблиці** | Найактивніші Таблиці із запитами, повільними запитами, перевищеннями часу очікування й найдовшою тривалістю запиту. | -| **Завдання** | Створені Teable завдання з виправлення зі станом, кількістю спроб, виконавцем і останньою помилкою. | +Для Таблиці, яку ще не налаштовували, оберіть **Налаштувати пошук**, а для вже налаштованої оберіть **Оновити вибір / перебудувати**. У діалозі потрібно вказати: -Над списком з’являється банер, коли проблема конфігурації блокує процес: шляхи доступу для пошуку налаштовані, але прапорець середовища виконання вимкнено; деякі Таблиці мають застарілий шлях доступу або шлях, що очікує перебудови, і їхній пошук непомітно повернувся до повільнішого сканування `ILIKE`; або найстаріше завдання в черзі очікує достатньо довго, щоб припустити відсутність активного виконавця. Усуньте проблему, про яку повідомляє банер, перш ніж працювати з рекомендаціями нижче. +| Пункт | Що вводити | +| --- | --- | +| **Постачальник пошуку** | `pg_bigm` або `pg_trgm`. Якщо розширення не встановлено, діалог повідомляє, чого бракує і хто може це виправити. | +| **Показовий текст пошуку** | Текст, який користувачі шукають насправді. Він перевіряє семантику підрядка та збирає дані плану виконання й ніколи не зберігається. Якщо він надто короткий, діалог називає мінімальну довжину. | +| **Поля** | Оберіть Поля, за якими користувачі справді шукають. У широкій Таблиці не обирайте все: будувати пошуковий документ для кожного Поля дорого. | -### Читання позначки рішення +**Проаналізувати й виконати пробний запуск** виконує зміну без фіксації та показує кількість охоплених Полів, оцінену кількість рядків, наявність даних плану виконання й наслідки створення чи перебудови. Для Таблиць з оцінкою від 50 000 рядків, а також невідомого розміру, додатково потрібне підтвердження вікна обслуговування. Далі оберіть **Підтвердити й додати завдання до черги**. -Кожна рекомендація має позначку останнього рішення системи: +Створення або перебудова покриття пошуку створює пошуковий стовпець та індекс GIN. Це може переписати всю Таблицю й утримувати блокування, а індексований пошук на час перерветься. Плануйте операцію на вікно обслуговування. -| Позначка | Значення | -| --- | --- | -| **Потрібне підтвердження вручну** | Застосувати цю рекомендацію може лише адміністратор. | -| **Тіньовий режим · було б виконано автоматично** | Рекомендація відповідає критеріям прийняття, але автоматичне виконання не ввімкнено, тому нічого не змінилося. | -| **Автоматичне виконання** / **Виконано автоматично** | Система автоматичного виконання прийняла й застосувала рекомендацію. | -| **Перевірку після виконання не пройдено · повторну спробу відкладено** | Автоматична зміна не пройшла перевірку. Teable довше чекатиме перед наступною спробою для цієї Таблиці. | -| **Період очікування** | Цю саму область нещодавно змінено, тому система поки що утримується від дій. | -| **Призупинено** / **Автоматичне виконання не застосовано** | Докази плану або розмір Таблиці не відповідають вимогам автоматичного виконання. | +Діалог повертає підтвердження додавання завдання, а не результат. Закрийте його й стежте за завданням у розділі **Завдання / історія**. Повторне надсилання тієї самої зміни поверне вже наявне завдання. -За замовчуванням Teable лише записує рішення й створює Записи рекомендацій і завдань; він не змінює базу даних самостійно. Автоматичне виконання вмикається окремо за допомогою `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`, і навіть тоді застосовується лише до малих Таблиць, план виконання яких демонструє явне зменшення вартості. Усі інші рекомендації очікують дії адміністратора. +## Керувати індексами фільтрування та сортування -### Додавання запропонованого індексу +Вкладка **Індекси фільтрування / сортування** перелічує фізичні індекси, які обслуговують умови фільтрування та сортування цієї Таблиці, із зазначенням дійсності, чи керує ним Teable, розміру й визначення. Вони керуються окремо від індексів підрядкового пошуку. -Якщо ви погоджуєтеся із запропонованим у рекомендації індексом, натисніть **Додати індекс** у відповідному рядку. Підтвердження приймає рекомендацію й виконує `CREATE INDEX CONCURRENTLY` для базової Таблиці PostgreSQL; якщо перевірку плану було пропущено, Teable усе одно створює індекс із рекомендованих Полів. У діалоговому вікні докази відображаються ще раз для остаточної перевірки. +Нижче в розділі **Дії, що очікують** зібрано рекомендації щодо індексів і позначку, чи підтверджені вони даними плану виконання. **Перевірити створення індексу** показує запропонований індекс, базу даних виконання й докази; після підтвердження Teable асинхронно виконує `CREATE INDEX CONCURRENTLY`. Для великих Таблиць і Таблиць невідомого розміру тут теж потрібне підтвердження вікна обслуговування. -Якщо орієнтовний розмір Таблиці становить щонайменше 50 000 рядків, перш ніж кнопка стане доступною, діалогове вікно попросить підтвердити наявність вікна технічного обслуговування. Одночасне створення індексу для великої Таблиці потребує часу й створює додаткове навантаження. +Ця сторінка не видаляє індекси. Некеровані та системні індекси можуть захищати обмеження або обслуговувати інші запити, тож їх не чіпають. -Після цього Teable повідомляє **Індекс створено** або **Рекомендацію прийнято й додано до черги**. У другому випадку стежте за завданням на вкладці **Завдання**. Якщо рекомендація не має придатного для виконання фізичного стовпця, команда **Додати індекс** залишається вимкненою з відповідним поясненням; натомість продовжте дослідження в робочій області аналізу. +## Діагностувати конкретні запити -## Виконання глибокого аналізу +Якщо про повільну Таблицю повідомили, а відповідної рекомендації немає, відкрийте вкладку **Діагностика запитів** і оберіть **Проаналізувати запити**. Аналіз лише читає збережені форми запитів і доступні дані плану виконання й нічого не створює. -Відкрийте **Робочу область аналізу**, щоб проаналізувати область за запитом, наприклад коли користувач повідомляє про повільну Таблицю, для якої ще немає рекомендації. +Висновок буває трьох видів: **Знайдено можливості індексації, підтверджені планом**, **Доступні плани не підтверджують можливості індексації** та **Недостатньо доказів**. Брак доказів не означає, що сталося послідовне сканування: саме лише спостереження повільного запиту не доводить, що причина в шляху доступу. Нижче перелічено кожен уражений запит із зазначенням, чи надійшов він із реального трафіку, чи зі збереженої конфігурації Перегляду, а також оцінену вартість плану до та після запропонованого індексу (вартість плану, а не мілісекунди). -| Тип аналізу | Призначення | -| --- | --- | -| **Запити й індекси** | Пошук ризиків запитів і можливих удосконалень індексів. | -| **Пошук підрядків** | Перевірка, чи може шлях доступу для пошуку підрядків пришвидшити пошук за входженням без зміни поведінки зіставлення. | +## Відстежувати результати -Виберіть **Таблиця**, **База** або **Простір**, введіть відповідний ідентифікатор і виберіть тип аналізу. Починайте з **Таблиці**, якщо вже знаєте, яка Таблиця працює повільно. +Вкладка **Завдання / історія** складається з трьох частин: -Натисніть **Створити звіт про запити** або **Створити звіт про пошук**. У звіті підсумовуються виявлені ризики й рекомендовані подальші дії. Для звіту про пошук **приклад пошуку EXPLAIN** необов’язковий. Додайте приклад, щоб перевірити сумісність результатів, плани запитів і час повторних запитів для запропонованого шляху доступу до пошуку підрядків. Teable не зберігає значення прикладу. +- **Завдання**: фонові завдання цієї Таблиці зі станом, кількістю спроб, типом завдання й причиною збою. Якщо завдання зрештою виконалося після збою, помилку позначено як попередню спробу. +- **Історія налаштувань пошуку**: постачальник, стан і список Полів кожної попередньої конфігурації покриття. +- **Історія рекомендацій**: прийняті, відхилені або замінені рекомендації. -Звіт про запити не змінює базу даних. Застосування рекомендації щодо пошуку підрядків потребує **прикладу пошуку EXPLAIN** і підтвердження адміністратора. +Історія завантажує лише найновіші записи. Якщо їх більше, рядок над списком показує загальну кількість. -Для великої Таблиці оцініть вплив і заплануйте всі підтверджені зміни на відповідне вікно технічного обслуговування. +Поки в Таблиці є завдання в черзі або в роботі, кнопки налаштування пошуку та створення індексів лишаються неактивними. Дочекайтеся завершення завдання. diff --git a/uk/basic/credential.mdx b/uk/basic/credential.mdx index 2005309e..127966e0 100644 --- a/uk/basic/credential.mdx +++ b/uk/basic/credential.mdx @@ -26,7 +26,7 @@ description: Керуйте своїми підключеннями й секр Підключення додається кнопкою **Підключити новий обліковий запис**. Коли авторизація втрачає чинність, у підключенні зʼявляється **Підключити знову**. -Біля кожного запису видно, скільки ресурсів його зараз використовують. Кнопка **Переглянути** відкриває перелік застосунків і автоматизацій, де для будь-якого з них можна **Відкликати доступ**. +Біля кожного запису видно, скільки ресурсів його зараз використовують. Кнопка **Переглянути** відкриває перелік застосунків і автоматизацій із зазначенням часу надання доступу, де для будь-якого з них можна **Відкликати доступ**. ## Надання облікових даних застосунку або автоматизації diff --git a/uk/basic/field/common/show-as.mdx b/uk/basic/field/common/show-as.mdx index 99fa7b73..509a231e 100644 --- a/uk/basic/field/common/show-as.mdx +++ b/uk/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "Інтерактивне відображення" -description: "Змінюйте відображення значень полів і поведінку під час натискання, зокрема для URL-адрес, електронної пошти, номерів телефону та числових діаграм." +description: "Змінюйте відображення значень полів і поведінку під час натискання, зокрема для електронної пошти, номерів телефону та числових діаграм." --- Інтерактивне відображення змінює вигляд значень полів і їхню поведінку під час натискання. Воно не змінює тип поля, а лише спосіб перегляду вмісту поля та взаємодії з ним. @@ -9,7 +9,6 @@ description: "Змінюйте відображення значень полі | Відображення | Опис | | --- | --- | -| URL | Відображає текст як вебадресу. Після натискання посилання відкривається в браузері | | Електронна пошта | Відображає текст як адресу електронної пошти. Після натискання відкривається стандартна поштова програма | | Телефон | Відображає текст як номер телефону. Після натискання запускається виклик, якщо пристрій це підтримує | diff --git a/uk/basic/field/long-text.mdx b/uk/basic/field/long-text.mdx index 8a4acd4f..4f9f3b32 100644 --- a/uk/basic/field/long-text.mdx +++ b/uk/basic/field/long-text.mdx @@ -46,5 +46,5 @@ description: "Зберігайте довгий текст із переноса ## Примітки -- Довгий текст не підтримує інтерактивне відображення URL-адрес, електронної пошти або телефону. Він підтримує лише звичайний текст і Markdown. -- Якщо вміст не потребує переносів рядків і має використовувати відображення URL-адреси, електронної пошти або телефону, скористайтеся Полем **Однорядковий текст**. +- Вебадреси в тексті автоматично стають посиланнями, на які можна натиснути, і налаштовувати нічого не потрібно. У розгорнутому Записі кнопка поряд із полем введення показує всі адреси, знайдені в комірці. +- Довгий текст не підтримує інтерактивне відображення електронної пошти або телефону. Якщо адресу чи номер потрібно натискати, щоб написати або зателефонувати, скористайтеся Полем **Однорядковий текст**. diff --git a/uk/basic/field/single-line-text.mdx b/uk/basic/field/single-line-text.mdx index 264cf238..d9770ce5 100644 --- a/uk/basic/field/single-line-text.mdx +++ b/uk/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ description: "Зберігайте короткий текст, як-от іме +## Автоматичне розпізнавання посилань + +Вебадреси в комірці автоматично стають посиланнями, на які можна натиснути, і налаштовувати нічого не потрібно. Розпізнаються адреси, що починаються з `https://` або `www.`, а також поширені домени на кшталт `teable.ai`. Якщо у значенні кілька адрес, кожна стає окремим посиланням. У розгорнутому Записі кнопка поряд із полем введення показує всі адреси, знайдені в комірці. + +Імена файлів і номери версій, як-от `readme.md` чи `v1.2.3`, за адреси не вважаються. + ## Режим відображення -Однорядковий текст підтримує чотири режими відображення: +Однорядковий текст підтримує три режими відображення: | Режим відображення | Для чого підходить | Дія після натискання | | --- | --- | --- | -| За замовчуванням | Імена, назви, ідентифікатори та інший звичайний текст | Додаткова дія після натискання відсутня | -| URL | Вебадреси | Відкриває URL-адресу в браузері за замовчуванням | +| За замовчуванням | Імена, назви, ідентифікатори та інший звичайний текст | Адреси стають посиланнями й відкриваються після натискання | | Електронна пошта | Електронні адреси | Відкриває поштову програму за замовчуванням | | Телефон | Номери телефонів | Відкриває програму зв’язку на пристрої. На мобільному пристрої користувачі можуть одразу зателефонувати за номером | @@ -45,7 +50,7 @@ description: "Зберігайте короткий текст, як-от іме ## Поширені способи використання -- **Керування контактами клієнтів**: створіть Поле «Вебсайт компанії» й установіть режим **URL**, щоб вебсайт відкривався після натискання. Створіть Поле «Телефон» і встановіть режим **Телефон**, щоб користувачі мобільних пристроїв могли зателефонувати одним дотиком. +- **Керування контактами клієнтів**: створіть Поле «Вебсайт компанії» й уведіть адресу, щоб вебсайт відкривався після натискання. Створіть Поле «Телефон» і встановіть режим **Телефон**, щоб користувачі мобільних пристроїв могли зателефонувати одним дотиком. - **Керування замовленнями або договорами**: створіть Поле «Ідентифікатор замовлення» або «Ідентифікатор договору» для пошуку, фільтрування й зіставлення із зовнішніми системами. - **Початковий статус звернення**: створіть Поле «Поточний етап» і встановіть значення за замовчуванням «Новий». Якщо етап походить із фіксованого робочого процесу, натомість використовуйте Поле **Одиночний вибір**. - **Видобування й об’єднання тексту**: посилайтеся на Однорядковий текст у формулах, щоб видобувати частини ідентифікаторів, об’єднувати відображувані імена або нормалізувати формат тексту. @@ -53,5 +58,5 @@ description: "Зберігайте короткий текст, як-от іме ## Примітки - Однорядковий текст призначений для короткого вмісту. Клавіша Enter зазвичай підтверджує введення. Для нотаток, резюме статей та іншого довгого вмісту використовуйте **Довгий текст**. -- URL, Електронна пошта й Телефон — це режими відображення. Поле залишається Однорядковим текстом, і його можна сортувати, фільтрувати й обробляти текстовими функціями. +- Електронна пошта й Телефон — це режими відображення. Поле залишається Однорядковим текстом, і його можна сортувати, фільтрувати й обробляти текстовими функціями. - Однорядковий текст не обмежує значення попередньо визначеними варіантами. Для статусів, категорій і пріоритетів, що потребують узгоджених значень, використовуйте **Одиночний вибір** або **Множинний вибір**. diff --git a/zh/basic/admin-panel/computed-outbox.mdx b/zh/basic/admin-panel/computed-outbox.mdx index 9535e973..e8944cf5 100644 --- a/zh/basic/admin-panel/computed-outbox.mdx +++ b/zh/basic/admin-panel/computed-outbox.mdx @@ -48,8 +48,8 @@ description: "在管理面板中监控 BullMQ 投递和计算任务积压。" | 板块 | 能回答什么 | | --- | --- | | 概要 | 端到端延迟、源头修改时间、收敛时间，以及触发这次计算的表和字段。带 **计算中** 徽章说明链路还在跑。| -| **时间线** | 这次运行的入队、开始执行、完成入库或失败的时间。| -| **任务链** | 级联中的每个任务，按入队它的上游任务缩进排列，可以看出某条分支从何而来。每行包含状态、计划步骤、**写入目标**（该任务更新的表和字段）、**脏记录数**、级联深度、入队时间和执行耗时。| +| **时间线** | 三条并排的时间轴：**端到端** 是源头改完到写入收敛，**本次执行** 是这个任务从领取到入库，**唤醒处理** 是执行它的那次唤醒。执行轴还会分段标出排队等待、领取准备、计算写入。唤醒处理会顺带清掉同一个数据库中其他到期任务，所以它比端到端长属于正常现象。| +| **任务链** | 级联中的每个任务，按入队它的上游任务缩进排列，可以看出某条分支从何而来。同一阶段拆出的分批是一条串行队列，会平铺在同一层，不再逐级缩进。每行包含状态、计划步骤、**写入目标**（该任务更新的表和字段）、**预估复杂度**、级联深度、入队时间和执行耗时。| | **字段传播图** | 这次运行读取和写入了哪些字段，以及改动如何在字段之间传播。浅蓝虚线是导向本次写入的源头字段，灰色是本次没有写入的输入字段，绿色是本次写入的字段；箭头表示字段依赖或沿链接传播，而不是执行顺序。图中只画出真正影响到本次写入的源头。传播链较长、在弹窗里看不清时，点击 **放大** 可以全屏查看。| 血缘账本只记录功能上线之后产生的任务，并保留 7 天。更早的任务只能看到队列信息，没有传播图。worker 还未生成计算计划的 seed 任务只会显示触发字段。如果这次变更本来就没有下游计算需要写入，图中会直接说明：没有公式、查找、汇总或链接标题依赖这些字段。 diff --git a/zh/basic/admin-panel/overview.mdx b/zh/basic/admin-panel/overview.mdx index 83508de8..0d80b39e 100644 --- a/zh/basic/admin-panel/overview.mdx +++ b/zh/basic/admin-panel/overview.mdx @@ -35,7 +35,7 @@ description: "Teable 私有化部署的管理员后台，用于管理实例的 ### 运维与审计 - **[自动化管理](/zh/basic/admin-panel/automation-management)**：查看自动化运行状态和历史记录 -- **[表格查询运维](/zh/basic/admin-panel/table-query-ops)**：分析表格查询风险和索引建议 +- **[表格查询运维](/zh/basic/admin-panel/table-query-ops)**：按表配置搜索覆盖、创建索引并跟进执行结果 - **[计算任务队列](/zh/basic/admin-panel/computed-outbox)**：监控计算任务投递、队列健康状态和数据库积压 - **[AI 生成队列](/zh/basic/admin-panel/ai-generation-queue)**：查看当前自托管实例内 AI 字段生成的运行状态 - **[沙箱 Agent](/zh/basic/admin-panel/sandbox-agent)**：配置和管理沙箱 Agent diff --git a/zh/basic/admin-panel/table-query-ops.mdx b/zh/basic/admin-panel/table-query-ops.mdx index d5a5444c..e0ba860e 100644 --- a/zh/basic/admin-panel/table-query-ops.mdx +++ b/zh/basic/admin-panel/table-query-ops.mdx @@ -1,85 +1,74 @@ --- title: "表格查询运维" -description: "查看慢表的查询风险推荐，并确认要执行的数据库优化。" +description: "按表查看搜索覆盖和索引现状，配置搜索、创建索引并跟进执行结果。" --- 私有化部署商业版及以上适用 路径：管理面板 → 表格查询运维 -当大表中的视图、筛选、关联或搜索变慢时，可以使用 **表格查询运维**。后台分析器会持续观测查询负载，并把观测结果整理成推荐。页面会列出这些推荐，实例管理员可以查看依据、对具体的表做深度分析，并确认需要执行的数据库变更。 +当大表中的视图、筛选、关联或搜索变慢时，可以使用 **表搜索与索引**。后台会持续观测查询负载，页面按表汇总现状：这张表现在用什么方式搜索、覆盖了哪些字段、有哪些物理索引、近期有多少慢查询。实例管理员可以在这里配置搜索覆盖、创建索引，并跟进执行结果。 -列表上方的计数概括了当前情况：观测窗口、请求数、慢查询、超时、待处理和已接受的推荐、执行中和失败的任务，以及有多少张表的搜索索引已就绪或已降级。 +页面只提交任务，不直接改数据库。所有变更都由后台任务异步执行，需要到 **任务 / 历史** 中确认结果。 -## 查看推荐 +## 找到需要处理的表 -页面默认打开 **推荐** 标签，并按优先级排序。分析器会同时衡量查询风险和表的使用热度，最值得处理的排在最前面。 +页面打开是表列表。顶部一排状态按钮带各自的数量，用来缩小范围： -搜索表、Base 或 Space 的 ID 可以在全部推荐中过滤；其他文本只在当前结果内过滤。状态和风险筛选器可以进一步缩小范围。 - -每条推荐都会标出所属的空间、Base 和表名。展开某一行，可以看到推荐依据、系统决策和 SQL 诊断信息： - -| 板块 | 说明 | +| 状态 | 含义 | | --- | --- | -| **触发来源** | 推荐从哪里来：实际查询观测、保存的视图配置，或关联字段配置。来自保存的视图配置说明还没观测到慢查询，是配置本身有风险。| -| **访问路径** | 这张表被顺序扫描和索引扫描命中的次数对比。| -| **原因** | 可读的成因，例如表数据量大、筛选或排序字段上没有可用索引、排序开销高、已观测到超时等。| -| **查询结构** | 具体在筛选和排序哪些字段，以及各自使用的匹配方式。| -| **建议索引** | 推荐准备建索引的字段，以及给出的理由。| +| **全部表** | 所有被观测到的表。| +| **需关注** | 有慢查询、超时、待处理建议或失败任务的表，优先从这里开始。| +| **已启用搜索索引** | 已经配置了搜索覆盖的表。| +| **未配置** | 还没有配置搜索覆盖的表。| +| **不可用** | 当前无法使用索引搜索的表，行内会给出原因。| -点击 **深度分析** 会打开分析工作台，并自动填入该表。 +搜索框支持表、数据库和空间的名称或 ID。排序可选 **慢查询最多** 或 **表名称**。**观测窗口** 可选最近 1 小时、24 小时或 7 天，列表中的观测数据都按这个窗口统计。 -当分析器观测到某张表存在大量子串搜索时，会针对整张表给出一条 **generated-text GIN** 推荐，而不是逐个字段建索引。这类推荐行会用 **创建搜索路径** 取代 **深度分析**，也不会出现 **添加索引**。该表建好搜索路径后，这条推荐会自动关闭。 +列表每行给出这张表的估算行数和体积、窗口内的请求数与慢查询数、当前搜索方式和字段覆盖情况、筛选 / 排序索引数量，以及待处理的建议数和活动任务数。点击表名进入详情。 -点击 **创建搜索路径** 会在当前页面弹窗中直接对该表做一次 dry-run，不需要跳转。弹窗会显示候选的索引提供方、覆盖字段数量、预估行数，以及启用前后的 `EXPLAIN` 成本。填写一个样例搜索词，长度不低于弹窗提示的最小字符数；这个词只用于校验，不会被保存。表较大时，还需要勾选维护窗口确认项。确认后，Teable 会再校验一次候选，然后启用搜索路径。 +## 配置搜索覆盖 -如果分析没有产出候选，弹窗会说明原因，不会执行任何操作。宽表会被拒绝，因为 Teable 不会为它建立覆盖全部字段的搜索文档，换更长的搜索词也没有用。此时点击 **按指定字段分析**，到分析工作台只分析用户真正会搜索的字段。 +表详情的 **搜索覆盖** 标签显示这张表当前的搜索方式、已覆盖字段数，以及每个字段的覆盖状态。点击 **显示未覆盖字段** 可以只看还没纳入的字段；标为 **不适用** 的字段无法用于子串搜索索引。 -旁边还有两个标签： +覆盖范围由显式选择决定。之后新建的字段不会自动纳入，需要重新配置一次才会加进来。超出覆盖范围的搜索，或者搜索词过短时，查询会回退为较慢的 `ILIKE` 扫描。 -| 标签 | 展示内容 | -| --- | --- | -| **热点表** | 最繁忙的表，包含请求数、慢查询、超时和最长查询耗时。| -| **任务** | Teable 创建的修复任务，包含状态、尝试次数、执行 worker 和最后一次错误。| +还没配置过的表点 **配置搜索**，已配置过的点 **更新字段选择 / 重建**。弹窗中需要填： -当配置问题拖住整个流程时，列表上方会出现提示横幅：已配置搜索访问路径但运行时开关未开启；部分表的访问路径处于 stale 或待重建状态，这些表的搜索已静默退回更慢的 `ILIKE` 扫描；或者最老的排队任务等待过久，说明可能没有 worker 在消费。先处理横幅中提示的问题，再去处理下方的推荐。 +| 项 | 说明 | +| --- | --- | +| **搜索提供程序** | `pg_bigm` 或 `pg_trgm`。数据库没有装对应扩展时，弹窗会说明缺什么、该找谁处理。| +| **代表性搜索词** | 填一个用户真会搜的词，用于校验子串语义并采集执行计划证据，不会被保存。太短时弹窗会提示所需的最小字符数。| +| **字段** | 勾选用户真正会搜的字段。宽表不要全选，为所有字段建搜索文档代价很高。| -### 读懂决策徽章 +点 **分析并预演** 做一次不落地的试算，弹窗会给出覆盖字段数、预估行数、是否已有执行计划证据，以及重建或新建带来的影响。预估行数达到 50,000 行及以上、或规模未知的表，还需要勾选维护窗口确认项。确认无误后点 **确认并提交任务**。 -每条推荐都会带上系统对它的最新决策： +创建或重建搜索覆盖会生成搜索列和 GIN 索引，可能重写整张表并持有锁，期间索引搜索会短暂中断。请安排在维护窗口执行。 -| 徽章 | 含义 | -| --- | --- | -| **需人工确认** | 只能由管理员确认执行。| -| **影子 · 可自动** | 推荐已满足自动执行条件，但自动执行未开启，因此没有做任何变更。| -| **自动执行中** / **已自动执行** | 自动执行已接受该推荐并完成变更。| -| **验收失败 · 退避中** | 自动变更没有通过验收，Teable 会等待更久再重试该表。| -| **冷却中** | 同一范围刚刚变更过，系统暂时不会再动它。| -| **暂不执行** / **自动执行未生效** | 计划依据或表的规模没有达到自动执行的标准。| +提交后弹窗给出的是任务回执，不是执行结果。关掉弹窗，到 **任务 / 历史** 跟进。同一个变更重复提交只会返回已有任务。 -默认情况下，Teable 只记录决策并生成推荐和任务记录，不会自动改动数据库。自动执行需要通过 `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto` 主动开启，且只对执行计划显示明显成本改善的小表生效，其余都会等待管理员确认。 +## 管理筛选 / 排序索引 -### 按建议添加索引 +**筛选 / 排序索引** 标签列出这张表上服务于筛选条件和排序的物理索引，每条标明有效性、是否由 Teable 托管，以及索引大小和定义。这类索引与子串搜索索引分开管理。 -如果认可某条推荐给出的索引，点击该行的 **添加索引**。确认后 Teable 会接受这条推荐，并在底层 PostgreSQL 表执行 `CREATE INDEX CONCURRENTLY`；执行计划未验证时，仍会按推荐字段建索引。弹窗里会再列一遍推荐依据，方便最后核对。 +下方的 **待处理操作** 是系统给出的索引建议，并标明是否已有执行计划证据。点 **审查索引创建** 查看建议的索引、执行所在的数据库和依据，确认后 Teable 会异步执行 `CREATE INDEX CONCURRENTLY`。大表或规模未知的表同样需要先勾选维护窗口确认项。 -预估行数达到 50,000 行及以上的表，需要先在弹窗中勾选确认已安排维护窗口，确认按钮才可用。大表的并发建索引耗时较长，执行期间会额外增加负载。 +此页面不支持删除索引。非托管索引和系统索引可能用于约束或其他查询，不会在这里被删掉。 -执行后 Teable 会提示 **索引已创建** 或 **已接受推荐并写入任务**；属于后者时，到 **任务** 标签跟进执行结果。如果这条推荐没有可执行的物理列，**添加索引** 会保持不可用并说明原因，此时改用分析工作台进一步排查。 +## 诊断具体查询 -## 发起深度分析 +用户反馈某张表慢，但没有对应建议时，打开 **查询诊断** 标签点 **分析查询**。分析只读取已保存的查询形态和执行计划证据，不会创建任何索引。 -点击 **分析工作台** 可以主动分析指定范围，例如用户反馈某张表很慢，但还没有对应的推荐时。 +结论有三种：**发现有执行计划支持的索引优化机会**、**现有执行计划未确认索引优化机会**、**证据不足**。证据不足时不要据此断定发生了顺序扫描，只有慢查询观测，不足以证明访问路径有问题。下方会逐条列出受影响的查询、它来自实际流量还是保存的视图配置，以及启用建议索引前后的计划成本估算（是计划成本，不是毫秒）。 -| 分析类型 | 适用场景 | -| --- | --- | -| **查询与索引** | 查找查询风险和可能的索引优化建议。| -| **子串搜索** | 判断子串搜索访问路径能否在保持匹配行为不变的情况下加快包含搜索。| +## 跟进执行结果 -选择 **表**、**Base** 或 **Space**，填写对应 ID，再选择分析类型。如果已经知道哪张表较慢，建议从 **表** 开始分析。 +**任务 / 历史** 标签包含三部分： -点击 **生成查询报告** 或 **生成搜索报告**。报告会汇总发现的风险和建议的后续操作。生成搜索报告时，**EXPLAIN 样例搜索词** 为可选项。填写后，报告会检查建议的子串搜索访问路径是否保持相同的查询结果，并比较执行计划和多次查询耗时。Teable 不会保存这个搜索词。 +- **任务**：这张表的后台任务，含状态、尝试次数、任务类型和失败原因。任务最终成功但此前失败过时，错误信息会标注为历史尝试。 +- **搜索配置历史**：历次搜索覆盖配置的提供程序、状态和字段列表。 +- **建议历史**：已接受、已忽略或已被替代的建议。 -查询报告不会修改数据库。执行子串搜索建议前，必须填写 **EXPLAIN 样例搜索词** 并由管理员确认。 +历史只加载最近若干条，超出时列表上方会说明总数。 -对于大表，请先评估影响，并把需要确认执行的变更安排在合适的维护窗口。 +表上有排队中或运行中的任务时，配置搜索和创建索引的按钮会暂时不可用，等任务结束后再操作。 diff --git a/zh/basic/credential.mdx b/zh/basic/credential.mdx index 08ade852..65e1b95b 100644 --- a/zh/basic/credential.mdx +++ b/zh/basic/credential.mdx @@ -26,7 +26,7 @@ description: 管理你的连接和 Secret，并把它们授权给应用和自动 连接通过 **连接新账户** 添加。授权失效时，对应连接上会出现 **重新连接**。 -每条凭据下方会显示它正在被多少个资源使用。点击 **查看** 可以看到具体的应用和自动化清单，并对其中某一项 **移除授权**。 +每条凭据下方会显示它正在被多少个资源使用。点击 **查看** 可以看到具体的应用和自动化清单，每项都标着授权时间，也可以对其中某一项 **移除授权**。 ## 授权给应用或自动化 diff --git a/zh/basic/field/common/show-as.mdx b/zh/basic/field/common/show-as.mdx index 9bbaa531..fa3aed9e 100644 --- a/zh/basic/field/common/show-as.mdx +++ b/zh/basic/field/common/show-as.mdx @@ -1,6 +1,6 @@ --- title: "交互展现" -description: "用于改变字段值的显示和点击行为，比如网址、邮箱、电话和数字图形展示。" +description: "用于改变字段值的显示和点击行为，比如邮箱、电话和数字图形展示。" --- 交互展现用于改变字段值的显示和点击行为。它不会改变字段类型，只影响字段内容的查看和操作方式。 @@ -9,7 +9,6 @@ description: "用于改变字段值的显示和点击行为，比如网址、邮 | 显示方式 | 说明 | | --- | --- | -| URL | 将文本显示为网址，点击后在浏览器中打开链接 | | Email | 将文本显示为邮箱地址，点击后打开默认邮箱应用 | | Phone | 将文本显示为电话号码，点击后启动拨打电话操作；具体行为取决于设备支持情况 | diff --git a/zh/basic/field/long-text.mdx b/zh/basic/field/long-text.mdx index b495b651..1a61d748 100644 --- a/zh/basic/field/long-text.mdx +++ b/zh/basic/field/long-text.mdx @@ -52,5 +52,5 @@ description: "用于存储需要换行的长文本，支持普通文本和 Markd ## 注意事项 -- 多行文本不支持 URL、Email 和电话这类交互展现，只支持普通文本和 Markdown。 -- 如果内容不需要换行，且希望设置 URL、Email 或电话显示方式，请使用 **单行文本** 字段。 +- 文本中的网址会自动变成可点击的链接，不需要任何设置。展开记录时，输入框旁会出现链接按钮，点开可以看到这个单元格里的全部网址。 +- 多行文本不支持 Email 和电话这类交互展现。需要点击邮箱或电话号码直接发信、拨号时，请使用 **单行文本** 字段。 diff --git a/zh/basic/field/single-line-text.mdx b/zh/basic/field/single-line-text.mdx index 1cce50de..a9f88864 100644 --- a/zh/basic/field/single-line-text.mdx +++ b/zh/basic/field/single-line-text.mdx @@ -30,14 +30,19 @@ description: "用于录入和存储姓名、标题、编号、网址等较短文 +## 网址自动识别 + +单元格里的网址会自动变成可点击的链接，不需要任何设置。`https://` 开头、`www.` 开头，以及 `teable.ai` 这类常见域名都能识别；一段文字里有多个网址时，每个都会单独成为链接。展开记录时，输入框旁会出现链接按钮，点开可以看到这个单元格里的全部网址。 + +文件名和版本号不会被误认成网址，比如 `readme.md`、`v1.2.3`。 + ## 显示方式 -单行文本支持四种显示方式： +单行文本支持三种显示方式： | 显示方式 | 适合内容 | 点击后的行为 | | --- | --- | --- | -| 默认 | 姓名、标题、编号等普通文本 | 无额外点击行为 | -| URL | 网页地址 | 用默认浏览器打开该网址 | +| 默认 | 姓名、标题、编号等普通文本 | 网址自动成为链接，点击即可打开 | | Email | 邮箱地址 | 打开默认邮箱应用 | | 电话 | 电话号码 | 打开设备上的通讯应用；在手机端访问时，可以直接拨打电话 | @@ -45,7 +50,7 @@ description: "用于录入和存储姓名、标题、编号、网址等较短文 ## 常见用法 -- **客户联系人管理**：新建“公司官网”字段并设为 **URL**，点击即可访问客户官网；新建“手机号”字段并设为 **电话**，在手机端可以一键拨打。 +- **客户联系人管理**：新建“公司官网”字段直接填网址，点击即可访问客户官网；新建“手机号”字段并设为 **电话**，在手机端可以一键拨打。 - **订单或合同管理**：新建“订单编号”或“合同编号”字段，用于搜索、筛选和对照外部系统记录。 - **工单初始状态**：新建“当前阶段”字段，并把默认值设为“新建”。之后每次添加工单记录时，字段会自动填入初始状态。如果阶段来自固定流程，建议改用 **单选** 字段。 - **文本提取和拼接**：在公式字段中引用单行文本，提取编号片段、拼接显示名称或统一文本格式。 @@ -53,5 +58,5 @@ description: "用于录入和存储姓名、标题、编号、网址等较短文 ## 注意事项 - 单行文本适合短内容，回车键通常用于确认输入。备注、文章摘要等长内容请使用 **多行文本** 字段。 -- URL、Email 和电话只是显示方式，不会改变字段类型。字段仍然是单行文本，可以参与排序、筛选和文本函数处理。 +- Email 和电话只是显示方式，不会改变字段类型。字段仍然是单行文本，可以参与排序、筛选和文本函数处理。 - 单行文本不会把内容限制为固定选项。需要统一状态、分类或优先级时，请使用 **单选** 或 **多选** 字段。