> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# أداة استعلام Databricks SQL

> أداة `DatabricksQueryTool` تنفذ استعلامات SQL على جداول مساحة عمل Databricks.

# `DatabricksQueryTool`

## الوصف

تنفيذ استعلامات SQL على جداول مساحة عمل Databricks باستخدام ملف تعريف CLI أو مصادقة المضيف/الرمز المباشرة.

## التثبيت

```shell theme={null}
uv add crewai-tools[databricks-sdk]
```

## متغيرات البيئة

* `DATABRICKS_CONFIG_PROFILE` أو (`DATABRICKS_HOST` + `DATABRICKS_TOKEN`)

أنشئ رمز وصول شخصي واعثر على تفاصيل المضيف في مساحة عمل Databricks ضمن إعدادات المستخدم ← المطور.
التوثيق: [https://docs.databricks.com/en/dev-tools/auth/pat.html](https://docs.databricks.com/en/dev-tools/auth/pat.html)

## مثال

```python Code theme={null}
from crewai import Agent, Task, Crew
from crewai_tools import DatabricksQueryTool

tool = DatabricksQueryTool(
    default_catalog="main",
    default_schema="default",
)

agent = Agent(
    role="Data Analyst",
    goal="Query Databricks",
    tools=[tool],
    verbose=True,
)

task = Task(
    description="SELECT * FROM my_table LIMIT 10",
    expected_output="10 rows",
    agent=agent,
)

crew = Crew(
    agents=[agent],
    tasks=[task],
    verbose=True,
)
result = crew.kickoff()

print(result)
```

## المعاملات

* `query` (مطلوب): استعلام SQL المراد تنفيذه
* `catalog` (اختياري): تجاوز الكتالوج الافتراضي
* `db_schema` (اختياري): تجاوز المخطط الافتراضي
* `warehouse_id` (اختياري): تجاوز مستودع SQL الافتراضي
* `row_limit` (اختياري): الحد الأقصى لعدد الصفوف المُرجعة (الافتراضي: 1000)

## القيم الافتراضية عند التهيئة

* `default_catalog`
* `default_schema`
* `default_warehouse_id`

### معالجة الأخطاء والنصائح

* أخطاء المصادقة: تحقق من أن `DATABRICKS_HOST` يبدأ بـ `https://` وأن الرمز صالح.
* الصلاحيات: تأكد من أن مستودع SQL والمخطط متاحان لرمزك.
* الحدود: يجب تجنب الاستعلامات طويلة التشغيل في حلقات الـ Agent؛ أضف فلاتر/حدود.