توابع عبور (RAWSQL) یا Pass-Through در Tableau

Pass-Through یا توابع عبور RAWSQL می‌توانند برای ارسال مستقیم عبارات SQL به پایگاه داده، بدون اینکه ابتدا توسط Tableau تفسیر شوند، استفاده شوند. اگر توابع پایگاه داده سفارشی دارید که Tableau از آنها اطلاعی ندارد، می‌توانید از این توابع عبور برای فراخوانی این توابع سفارشی استفاده کنید.

پایگاه داده شما معمولاً نام فیلدهایی را که در Tableau نشان داده می‌شوند، درک نمی‌کند. از آنجا که Tableau عبارات SQL را که در توابع عبور قرار می‌دهید، تفسیر نمی‌کند، استفاده از نام فیلدهای Tableau در عبارت شما ممکن است باعث خطا شود. می‌توانید از یک سینتکس جایگزینی برای وارد کردن نام فیلد یا عبارت صحیح برای محاسبه Tableau در SQL عبور استفاده کنید. به عنوان مثال، اگر تابعی داشتید که میانه مجموعه‌ای از مقادیر را محاسبه می‌کرد، می‌توانید آن تابع را روی ستون Tableau [فروش] به این صورت فراخوانی کنید:

RAWSQLAGG_REAL(“MEDIAN(%1)”, [Sales])

از آنجا که Tableau عبارت را تفسیر نمی‌کند، باید تجمیع را تعریف کنید. می‌توانید هنگام استفاده از عبارات تجمیعی از توابع RAWSQLAGG که در زیر توضیح داده شده است استفاده کنید.

توابع انتقال RAWSQL با منابع داده منتشر شده یا با استخراج‌های Tableau کار نمی‌کنند.
این توابع ممکن است از Tableau Desktop 8.2 به بعد نتایج متفاوتی نسبت به نسخه‌های قبلی Tableau Desktop ارائه دهند. دلیل این امر این است که Tableau اکنون به جای OLE DB از ODBC برای توابع انتقال استفاده می‌کند. ODBC هنگام بازگشت مقادیر واقعی به عنوان عدد صحیح، کوتاه می‌کند؛ OLE DB هنگام بازگشت مقادیر واقعی به عنوان عدد صحیح، گرد می‌کند.

توابع RAWSQL

توابع RAWSQL زیر در Tableau موجود است.

RAWSQL_BOOL(“sql_expr”, [arg1], …[argN])

یک نتیجه Boolean از یک عبارت SQL داده شده را برمی‌گرداند. عبارت SQL مستقیماً به پایگاه داده اصلی ارسال می‌شود. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید.

مثال : در مثال، %1 برابر با [فروش] و %2 برابر با [سود] است.

RAWSQL_BOOL("%1 > %2", [Sales], [Profit])

RAWSQL_DATE(“sql_expr”, [arg1], …[argN])

نتیجه‌ی تاریخ را از یک عبارت SQL داده شده برمی‌گرداند. عبارت SQL مستقیماً به پایگاه داده‌ی اصلی ارسال می‌شود. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید.

مثال : در این مثال، %1 برابر با [تاریخ سفارش] است.

RAWSQL_DATE(“%1”, [Order Date])

RAWSQL_DATETIME(“sql_expr”, [arg1], …[argN])

نتیجه تاریخ و زمان را از یک عبارت SQL داده شده برمی‌گرداند. عبارت SQL مستقیماً به پایگاه داده اصلی ارسال می‌شود. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [تاریخ تحویل] است.

مثال :

RAWSQL_DATETIME("%1", [Order Date])

RAWSQL_INT(“sql_expr”, [arg1], …[argN])

یک نتیجه صحیح از یک عبارت SQL داده شده را برمی‌گرداند. عبارت SQL مستقیماً به پایگاه داده اصلی ارسال می‌شود. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [فروش] است.

مثال :

RAWSQL_INT(“500 + %1”, [Sales])

RAWSQL_REAL(“sql_expr”, [arg1], …[argN])

یک نتیجه عددی از یک عبارت SQL داده شده را که مستقیماً به پایگاه داده اصلی ارسال می‌شود، برمی‌گرداند. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [فروش] است.

مثال :

RAWSQL_REAL(“-123.98 * %1”, [Sales])

RAWSQL_SPATIAL

یک مقدار مکانی از یک عبارت SQL داده شده را که مستقیماً به منبع داده اصلی منتقل می‌شود، برمی‌گرداند. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید.

مثال: در این مثال، %1 برابر با [هندسه] است.

RAWSQL_SPATIAL("%1", [Geometry])

RAWSQL_STR(“sql_expr”, [arg1], …[argN])

رشته‌ای را از یک عبارت SQL داده شده که مستقیماً به پایگاه داده اصلی ارسال می‌شود، برمی‌گرداند. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [نام مشتری] است.

مثال:

RAWSQL_STR(“%1”, [Customer Name])

RAWSQLAGG_BOOL(“sql_expr”, [arg1], …[argN])

یک نتیجه بولی از یک عبارت SQL تجمیعی داده شده را برمی‌گرداند. عبارت SQL مستقیماً به پایگاه داده اصلی ارسال می‌شود. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید.

مثال : در این مثال، %1 برابر با [فروش] و %2 برابر با [سود] است.

RAWSQLAGG_BOOL(“SUM( %1) >SUM( %2)”, [Sales], [Profit])

RAWSQLAGG_DATE(“sql_expr”, [arg1], …[argN])

نتیجه‌ی تاریخ را از یک عبارت SQL تجمیعی داده شده برمی‌گرداند. عبارت SQL مستقیماً به پایگاه داده‌ی اصلی ارسال می‌شود. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [تاریخ سفارش] است.

مثال :

RAWSQLAGG_DATE(“MAX(%1)”, [Order Date])

RAWSQLAGG_DATETIME(“sql_expr”, [arg1], …[argN])

نتیجه تاریخ و زمان را از یک عبارت SQL تجمیعی داده شده برمی‌گرداند. عبارت SQL مستقیماً به پایگاه داده اصلی ارسال می‌شود. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [تاریخ تحویل] است.

مثال :

RAWSQLAGG_DATETIME(“MIN(%1)”, [Delivery Date])

RAWSQLAGG_INT(“sql_expr”, [arg1,] …[argN])

یک نتیجه صحیح از یک عبارت SQL تجمیعی داده شده را برمی‌گرداند. عبارت SQL مستقیماً به پایگاه داده اصلی ارسال می‌شود. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [Sales] است.

مثال :

RAWSQLAGG_INT(“500 + SUM(%1)”, [Sales])

RAWSQLAGG_REAL(“sql_expr”, [arg1,] …[argN])

یک نتیجه عددی از یک عبارت SQL تجمیعی داده شده را که مستقیماً به پایگاه داده اصلی ارسال می‌شود، برمی‌گرداند. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [فروش] است.

مثال :

RAWSQLAGG_REAL(“SUM( %1)”, [Sales])

RAWSQLAGG_STR(“sql_expr”, [arg1,] …[argN])

رشته‌ای را از یک عبارت SQL تجمیعی داده شده که مستقیماً به پایگاه داده اصلی ارسال می‌شود، برمی‌گرداند. از %n در عبارت SQL به عنوان یک سینتکس جایگزینی برای مقادیر پایگاه داده استفاده کنید. در این مثال، %1 برابر با [Discount] است.

مثال :

RAWSQLAGG_STR(“AVG(%1)”, [Discount])