'\" t .\" Title: tinysparql-introspect .\" Author: The TinySPARQL developers .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 04/15/2026 .\" Manual: TinySPARQL manual .\" Source: \ \& 3.11.1 .\" Language: English .\" .TH "TINYSPARQL\-INTROSPE" "1" "04/15/2026" "\ \& 3\&.11\&.1" "TinySPARQL manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" tinysparql-introspect \- درون‌نگری و بررسی نقاط پایانی SPARQL\&. .SH "خلاصه دستور (SYNOPSIS)" .sp .nf tinysparql introspect [(\-d |\-\-database) | (\-b | \-\-dbus\-service) | (\-r | \-\-remote\-service) ] [(\-t | \-\-tree)] [(\-t | \-\-tree) ] [(\-s | \-\-search) ]t tinysparql introspect [(\-d |\-\-database) | (\-b | \-\-dbus\-service) | (\-r | \-\-remote\-service) ] [(\-c | \-\-list\-classes)] [(\-p | \-\-list\-properties)] [(\-i | \-\-list\-indexes)] [(\-n | \-\-list\-notifies)] [(\-g | \-\-list\-graphs)] .fi .SH "توضیحات (DESCRIPTION)" .sp این دستور امکان کاوش و بررسی شمای پایگاه‌داده فعلی (که با نام آنتولوژی نیز شناخته می‌شود) و قابلیت‌های نقطه پایانی (endpoint) را فراهم می‌کند\&. اگر بدون هیچ آرگومان دیگری به‌جز مورد مشخص‌کنندهٔ اتصال پایگاه‌داده فراخوانی شود، تمامی اطلاعات استخراج خواهند شد\&. .sp از نظر آنتولوژی پایگاه‌داده، به‌سادگی می‌توان دریافت چه ویژگی‌هایی برای سرعت بیشتر نمایه‌سازی شده‌اند یا در هنگام تغییرات اعلان ارسال می‌کنند، چه کلاس‌هایی در دسترس هستند و ویژگی‌های متعلق به هر کلاس کدامند\&. همچنین ابزارهای بصری برای نمایش چیدمان درختی اسکی (ASCII) کلاس‌ها و روابط آن‌ها با یکدیگر وجود دارد\&. .SH "گزینه‌ها (OPTIONS)" .PP \fB\-b, \-\-dbus\-service=<\fR\fB\fIservice_name\fR\fR\fB>\fR .RS 4 به یک نقطه پایانی SPARQL روی یک نام D\-Bus متصل می‌شود\&. .RE .PP \fB\-d, \-\-database\-path=<\fR\fB\fIdatabase_path\fR\fR\fB>\fR .RS 4 بر اساس مکان موجود در سیستم‌فایل به یک پایگاه‌داده متصل می‌شود\&. .RE .PP \fB\-r, \-\-remote\-service=<\fR\fB\fIurl\fR\fR\fB>\fR .RS 4 به یک نقطه پایانی SPARQL از نوع HTTP متصل می‌شود\&. .RE .PP \fB\-c, \-\-list\-classes\fR .RS 4 فهرستی از کلاس‌هایی را برمی‌گرداند که آنتولوژیِ مورد استفاده برای ذخیره‌سازی داده‌ها را توصیف می‌کنند\&. این کلاس‌ها در پرس‌وجوها نیز استفاده می‌شوند\&. برای نمونه، \fIhttp://www\&.w3\&.org/2000/01/rdf\-schema#Resource\fR یکی از کلاس‌های متعددی است که باید در اینجا بازگردانده شود\&. .RE .PP \fB\-x, \-\-list\-class\-prefixes\fR .RS 4 فهرستی از پیشوندها را در دو قالب کوتاه و بلند برمی‌گرداند\&. تمامی کلاس‌ها و ویژگی‌های RDF دارای چنین پیشوندی هستند که می‌توان آن را به هر دو شکل بیان کرد\&. .RE .PP \fB\-p, \-\-list\-properties=[\fR\fB\fIclass\fR\fR\fB]\fR .RS 4 فهرستی از ویژگی‌های مربوط به یک \fIclass\fR را برمی‌گرداند\&. می‌توانید از هر دو قالب برای \fIclass\fR استفاده کنید؛ چه نام کامل \fIhttp://tracker\&.api\&.gnome\&.org/ontology/v3/nfo#Video\fR و چه نام کوتاه با پیشوند \fInfo:Video\fR\&. همچنین ببینید: \fB\-\-tree\fR و \fB\-\-query\fR\&. .RE .PP \fB\-n, \-\-list\-notifies=[\fR\fB\fIclass\fR\fR\fB]\fR .RS 4 فهرستی از کلاس‌هایی را برمی‌گرداند که در مورد هرگونه تغییر در پایگاه‌داده، از طریق D\-Bus اعلان دریافت می‌کنند\&. نیازی به ارائهٔ \fIclass\fR در اینجا نیست\&. این آرگومان اختیاری است و نتایج را بر اساس آرگومان ارائه‌شده فیلتر می‌کند\&. در صورت مشخص نکردن \fIclass\fR، تمام کلاس‌ها فهرست می‌شوند\&. .RE .PP \fB\-i, \-\-list\-indexes=[\fR\fB\fIproperty\fR\fR\fB]\fR .RS 4 فهرستی از ویژگی‌هایی را برمی‌گرداند که در پایگاه‌داده نمایه‌سازی شده‌اند\&. نمایه‌ها سرعت پرس‌وجو را افزایش می‌دهند اما هزینهٔ زمانی نمایه‌سازی نیز دارند\&. نیازی به ارائهٔ \fIproperty\fR در اینجا نیست\&. این آرگومان اختیاری است و نتایج را بر اساس آرگومان ارائه‌شده فیلتر می‌کند\&. در صورت مشخص نکردن \fIproperty\fR، تمام ویژگی‌ها فهرست می‌شوند\&. .RE .PP \fB\-g, \-\-list\-graphs\fR .RS 4 تمامی گراف‌های نام‌گذاری‌شده (named graphs) در پایگاه‌داده را فهرست می‌کند\&. این موارد توسط کاوشگر سیستم‌فایل (filesystem miner) برای تفکیک فراداده‌ها استفاده می‌شوند تا برنامه‌ها فقط اطلاعات مرتبط با خود را مشاهده کنند\&. .RE .PP \fB\-t, \-\-tree=[\fR\fB\fIclass\fR\fR\fB]\fR .RS 4 یک ساختار درختی شامل تمام کلاس‌های والدِ \fIclass\fR را در آنتولوژی نمایش می‌دهد\&. \fIclass\fR می‌تواند به صورت کوتاه یا کامل ارائه شود (برای جزئیات بیشتر به \fB\-\-get\-shorthand\fR و \fB\-\-get\-longhand\fR مراجعه کنید)\&. .RE .sp اگر هیچ \fIclass\fR مشخص نشود، کل ساختار درختی نمایش داده می‌شود\&. .sp گزینهٔ خط فرمان \fB\-\-search\fR می‌تواند برای برجسته‌سازی بخش‌هایی از درخت که به دنبال آن‌ها هستید استفاده شود\&. جستجو به بزرگی و کوچکی حروف حساس نیست\&. .sp گزینهٔ خط فرمان \fB\-\-properties\fR می‌تواند برای نمایش ویژگی‌های هر کلاسِ نمایش‌داده‌شده به کار رود\&. .PP \fB\-s, \-\-search=<\fR\fB\fIneedle\fR\fR\fB>\fR .RS 4 فهرستی از کلاس‌ها و ویژگی‌هایی را برمی‌گرداند که در آنتولوژی تا حدی با \fIneedle\fR مطابقت دارند\&. جستجو به بزرگی و کوچکی حروف حساس نیست\&. همچنین ببینید: \fB\-\-tree\fR\&. .RE .SH "همچنین ببینید (SEE ALSO)" .sp \fBtinysparql\-endpoint\fR(1)\&.