TINYSPARQL-INTROSPE(1) TinySPARQL manual TINYSPARQL-INTROSPE(1)

tinysparql-introspect - درون‌نگری و بررسی نقاط پایانی SPARQL.

tinysparql introspect [(-d |--database) <file> | (-b | --dbus-service) <busname> | (-r | --remote-service) <url>]
    [(-t | --tree)] [(-t | --tree) <class>] [(-s | --search) <needle>]t
tinysparql introspect [(-d |--database) <file> | (-b | --dbus-service) <busname> | (-r | --remote-service) <url>]
    [(-c | --list-classes)] [(-p | --list-properties)] [(-i | --list-indexes)] [(-n | --list-notifies)] [(-g | --list-graphs)]

این دستور امکان کاوش و بررسی شمای پایگاه‌داده فعلی (که با نام آنتولوژی نیز شناخته می‌شود) و قابلیت‌های نقطه پایانی (endpoint) را فراهم می‌کند. اگر بدون هیچ آرگومان دیگری به‌جز مورد مشخص‌کنندهٔ اتصال پایگاه‌داده فراخوانی شود، تمامی اطلاعات استخراج خواهند شد.

از نظر آنتولوژی پایگاه‌داده، به‌سادگی می‌توان دریافت چه ویژگی‌هایی برای سرعت بیشتر نمایه‌سازی شده‌اند یا در هنگام تغییرات اعلان ارسال می‌کنند، چه کلاس‌هایی در دسترس هستند و ویژگی‌های متعلق به هر کلاس کدامند. همچنین ابزارهای بصری برای نمایش چیدمان درختی اسکی (ASCII) کلاس‌ها و روابط آن‌ها با یکدیگر وجود دارد.

-b, --dbus-service=<service_name>

به یک نقطه پایانی SPARQL روی یک نام D-Bus متصل می‌شود.

-d, --database-path=<database_path>

بر اساس مکان موجود در سیستم‌فایل به یک پایگاه‌داده متصل می‌شود.

-r, --remote-service=<url>

به یک نقطه پایانی SPARQL از نوع HTTP متصل می‌شود.

-c, --list-classes

فهرستی از کلاس‌هایی را برمی‌گرداند که آنتولوژیِ مورد استفاده برای ذخیره‌سازی داده‌ها را توصیف می‌کنند. این کلاس‌ها در پرس‌وجوها نیز استفاده می‌شوند. برای نمونه، http://www.w3.org/2000/01/rdf-schema#Resource یکی از کلاس‌های متعددی است که باید در اینجا بازگردانده شود.

-x, --list-class-prefixes

فهرستی از پیشوندها را در دو قالب کوتاه و بلند برمی‌گرداند. تمامی کلاس‌ها و ویژگی‌های RDF دارای چنین پیشوندی هستند که می‌توان آن را به هر دو شکل بیان کرد.

-p, --list-properties=[class]

فهرستی از ویژگی‌های مربوط به یک class را برمی‌گرداند. می‌توانید از هر دو قالب برای class استفاده کنید؛ چه نام کامل http://tracker.api.gnome.org/ontology/v3/nfo#Video و چه نام کوتاه با پیشوند nfo:Video. همچنین ببینید: --tree و --query.

-n, --list-notifies=[class]

فهرستی از کلاس‌هایی را برمی‌گرداند که در مورد هرگونه تغییر در پایگاه‌داده، از طریق D-Bus اعلان دریافت می‌کنند. نیازی به ارائهٔ class در اینجا نیست. این آرگومان اختیاری است و نتایج را بر اساس آرگومان ارائه‌شده فیلتر می‌کند. در صورت مشخص نکردن class، تمام کلاس‌ها فهرست می‌شوند.

-i, --list-indexes=[property]

فهرستی از ویژگی‌هایی را برمی‌گرداند که در پایگاه‌داده نمایه‌سازی شده‌اند. نمایه‌ها سرعت پرس‌وجو را افزایش می‌دهند اما هزینهٔ زمانی نمایه‌سازی نیز دارند. نیازی به ارائهٔ property در اینجا نیست. این آرگومان اختیاری است و نتایج را بر اساس آرگومان ارائه‌شده فیلتر می‌کند. در صورت مشخص نکردن property، تمام ویژگی‌ها فهرست می‌شوند.

-g, --list-graphs

تمامی گراف‌های نام‌گذاری‌شده (named graphs) در پایگاه‌داده را فهرست می‌کند. این موارد توسط کاوشگر سیستم‌فایل (filesystem miner) برای تفکیک فراداده‌ها استفاده می‌شوند تا برنامه‌ها فقط اطلاعات مرتبط با خود را مشاهده کنند.

-t, --tree=[class]

یک ساختار درختی شامل تمام کلاس‌های والدِ class را در آنتولوژی نمایش می‌دهد. class می‌تواند به صورت کوتاه یا کامل ارائه شود (برای جزئیات بیشتر به --get-shorthand و --get-longhand مراجعه کنید).

اگر هیچ class مشخص نشود، کل ساختار درختی نمایش داده می‌شود.

گزینهٔ خط فرمان --search می‌تواند برای برجسته‌سازی بخش‌هایی از درخت که به دنبال آن‌ها هستید استفاده شود. جستجو به بزرگی و کوچکی حروف حساس نیست.

گزینهٔ خط فرمان --properties می‌تواند برای نمایش ویژگی‌های هر کلاسِ نمایش‌داده‌شده به کار رود.

-s, --search=<needle>

فهرستی از کلاس‌ها و ویژگی‌هایی را برمی‌گرداند که در آنتولوژی تا حدی با needle مطابقت دارند. جستجو به بزرگی و کوچکی حروف حساس نیست. همچنین ببینید: --tree.

tinysparql-endpoint(1).

04/15/2026   3.11.1