> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Unity Catalog

> في هذا الدليل، سنستعرض الخطوات اللازمة للاستعلام عن بياناتك المخزّنة في حاويات S3 باستخدام ClickHouse وUnity Catalog.

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                ميزة Beta. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        مزيد من المعلومات.
                    </a>
                </u>
            </span>
        </div>;
};

يدعم ClickHouse التكامل مع عدة كتالوجات (Unity وGlue وPolaris وغيرها). يوضح هذا الدليل الخطوات اللازمة للاستعلام عن بياناتك المُدارة في Databricks باستخدام ClickHouse و[Unity Catalog](https://www.databricks.com/product/unity-catalog).

يدعم Databricks عدة تنسيقات بيانات في بيئة lakehouse الخاصة به. وباستخدام ClickHouse، يمكنك الاستعلام عن جداول Unity Catalog بصيغتَي Delta وIceberg.

<Note>
  نظرًا إلى أن هذه الميزة تجريبية، ستحتاج إلى تفعيلها باستخدام:
  `SET allow_experimental_database_unity_catalog = 1;`
</Note>

<div id="configuring-unity-in-databricks">
  ## تهيئة Unity في Databricks
</div>

للسماح لـ ClickHouse بالتفاعل مع Unity Catalog، عليك التأكد من أن Unity Catalog مُعَدّ للسماح بالتفاعل مع قارئ خارجي. ويمكن تحقيق ذلك باتباع دليل [«تمكين الوصول إلى البيانات الخارجية في Unity Catalog»](https://docs.databricks.com/aws/en/external-access/admin).

بعد تهيئة الكتالوج، يجب إنشاء بيانات اعتماد لـ ClickHouse. ويمكن استخدام طريقتين مختلفتين بحسب نمط التفاعل مع Unity:

* بالنسبة إلى عملاء Iceberg، استخدم المصادقة عبر [service principal](https://docs.databricks.com/aws/en/dev-tools/auth/oauth-m2m).

* بالنسبة إلى عملاء Delta، استخدم رمز وصول شخصي ([PAT](https://docs.databricks.com/aws/en/dev-tools/auth/pat)).

<div id="required-pat-token-permissions">
  ### أذونات رمز PAT المطلوبة
</div>

عند استخدام PAT للوصول للقراءة، يجب أن يمتلك الرمز المميز أذونات تتيح لـ ClickHouse إدراج البيانات الوصفية في Unity Catalog وقراءتها. تأكد من أن PAT يمتلك على الأقل [امتياز](https://docs.databricks.com/aws/en/external-access/admin#grant-a-principal-unity-catalog-privileges) `EXTERNAL USE SCHEMA`، بالإضافة إلى إذن `SELECT` على الجدول، و`USE CATALOG` على الكتالوج الأصل، و`USE SCHEMA` على المخطط الأصل.

<div id="creating-a-connection-between-unity-catalog-and-clickhouse">
  ## إنشاء connection بين Unity Catalog وClickHouse
</div>

بعد إعداد Unity Catalog وتفعيل authentication، أنشئ connection بين ClickHouse وUnity Catalog.

<div id="read-delta">
  ### قراءة Delta
</div>

```sql theme={null}
CREATE DATABASE unity
ENGINE = DataLakeCatalog('https://<workspace-id>.cloud.databricks.com/api/2.1/unity-catalog')
SETTINGS warehouse = 'CATALOG_NAME', catalog_credential = '<PAT>', catalog_type = 'unity'
```

<div id="read-iceberg">
  ### قراءة جداول Iceberg
</div>

للوصول إلى جداول Iceberg المُدارة:

```sql theme={null}
CREATE DATABASE unity
ENGINE = DataLakeCatalog('https://<workspace-id>.cloud.databricks.com/api/2.1/unity-catalog/iceberg-rest')
SETTINGS catalog_type = 'rest', catalog_credential = '<client-id>:<client-secret>', warehouse = 'workspace', 
oauth_server_uri = 'https://<workspace-id>.cloud.databricks.com/oidc/v1/token', auth_scope = 'all-apis,sql'
```

<div id="querying-unity-catalog-tables-using-clickhouse">
  ## الاستعلام عن جداول Unity Catalog باستخدام ClickHouse
</div>

الآن وبعد إعداد الاتصال، يمكنك البدء في الاستعلام عبر Unity Catalog. على سبيل المثال:

```sql theme={null}
USE unity;

SHOW TABLES;
```

```response theme={null}
┌─name───────────────────────────────────────────────┐
│ clickbench.delta_hits                              │
│ demo.fake_user                                     │
│ information_schema.catalog_privileges              │
│ information_schema.catalog_tags                    │
│ information_schema.catalogs                        │
│ information_schema.check_constraints               │
│ information_schema.column_masks                    │
│ information_schema.column_tags                     │
│ information_schema.columns                         │
│ information_schema.constraint_column_usage         │
│ information_schema.constraint_table_usage          │
│ information_schema.information_schema_catalog_name │
│ information_schema.key_column_usage                │
│ information_schema.parameters                      │
│ information_schema.referential_constraints         │
│ information_schema.routine_columns                 │
│ information_schema.routine_privileges              │
│ information_schema.routines                        │
│ information_schema.row_filters                     │
│ information_schema.schema_privileges               │
│ information_schema.schema_tags                     │
│ information_schema.schemata                        │
│ information_schema.table_constraints               │
│ information_schema.table_privileges                │
│ information_schema.table_tags                      │
│ information_schema.tables                          │
│ information_schema.views                           │
│ information_schema.volume_privileges               │
│ information_schema.volume_tags                     │
│ information_schema.volumes                         │
│ uniform.delta_hits                                 │
└────────────────────────────────────────────────────┘
```

```sql theme={null}
SHOW TABLES
```

```response theme={null}
┌─name───────────────┐
│ uniform.delta_hits │
└────────────────────┘
```

للاستعلام عن جدول:

```sql theme={null}
SELECT count(*) FROM `uniform.delta_hits`
```

<Info>
  **العلامات (\`) مطلوبة**

  العلامات (\`) مطلوبة لأن ClickHouse لا يدعم سوى مساحة اسم واحدة.
</Info>

لفحص DDL الخاص بالجدول:

```sql theme={null}
SHOW CREATE TABLE `uniform.delta_hits`

CREATE TABLE unity_uniform.`uniform.delta_hits`
(
    `WatchID` Int64,
    `JavaEnable` Int32,
    `Title` String,
    `GoodEvent` Int32,
    `EventTime` DateTime64(6, 'UTC'),
    `EventDate` Date,
    `CounterID` Int32,
    `ClientIP` Int32,
    ...
    `FromTag` String,
    `HasGCLID` Int32,
    `RefererHash` Int64,
    `URLHash` Int64,
    `CLID` Int32
)
ENGINE = Iceberg('s3://<path>);

```

<div id="loading-data-from-your-data-lake-into-clickhouse">
  ## تحميل البيانات من بحيرة البيانات لديك إلى ClickHouse
</div>

إذا كنت بحاجة إلى تحميل البيانات من Databricks إلى ClickHouse، فابدأ بإنشاء جدول محلي في ClickHouse:

```sql theme={null}
CREATE TABLE hits
(
    `WatchID` Int64,
    `JavaEnable` Int32,
    `Title` String,
    `GoodEvent` Int32,
    `EventTime` DateTime64(6, 'UTC'),
    `EventDate` Date,
    `CounterID` Int32,
    `ClientIP` Int32,
    ...
    `FromTag` String,
    `HasGCLID` Int32,
    `RefererHash` Int64,
    `URLHash` Int64,
    `CLID` Int32
)
PRIMARY KEY (CounterID, EventDate, UserID, EventTime, WatchID);
```

ثم حمّل البيانات من جدول Unity Catalog لديك باستخدام `INSERT INTO SELECT`:

```sql theme={null}
INSERT INTO hits SELECT * FROM unity_uniform.`uniform.delta_hits`;
```