سمات القاموس

توضح عبارة structure مفتاح القاموس والحقول المتاحة للاستعلامات.

وصف XML:

<dictionary>
    <structure>
        <id>
            <name>Id</name>
        </id>

        <attribute>
            <!-- Attribute parameters -->
        </attribute>

        ...

    </structure>
</dictionary>

تُوصَف السمات في العناصر التالية:

• <id> — عمود المفتاح
• <attribute> — عمود البيانات: يمكن أن يوجد أكثر من سمة واحدة.

استعلام DDL:

CREATE DICTIONARY dict_name (
    Id UInt64,
    -- attributes
)
PRIMARY KEY Id
...

تُوصَف السمات في نص الاستعلام:

• PRIMARY KEY — عمود المفتاح
• AttrName AttrType — عمود البيانات. يمكن أن تكون هناك عدة سمات.

يدعم ClickHouse الأنواع التالية من المفاتيح:

• مفتاح رقمي. UInt64. يُعرَّف في الوسم <id> أو باستخدام الكلمة المفتاحية PRIMARY KEY.
• مفتاح مركب. مجموعة من القيم من أنواع مختلفة. يُعرَّف في الوسم <key> أو باستخدام الكلمة المفتاحية PRIMARY KEY.

يمكن أن تحتوي بنية XML على <id> أو <key> فقط. ويجب أن يحتوي استعلام DDL على PRIMARY KEY واحد فقط.

النوع: UInt64.

مثال على التهيئة:

<id>
    <name>Id</name>
</id>

حقول الإعداد:

• name – اسم العمود الذي يحتوي على المفاتيح.

لاستعلام DDL:

CREATE DICTIONARY (
    Id UInt64,
    ...
)
PRIMARY KEY Id
...

• PRIMARY KEY – اسم العمود الذي يتضمن المفاتيح.

يمكن أن يكون المفتاح tuple مكوَّنًا من حقول بأي أنواع. ويجب أن يكون التخطيط في هذه الحالة complex_key_hashed أو complex_key_cache.

يُحدَّد تركيب المفتاح في العنصر <key>. وتُحدَّد حقول المفتاح بالتنسيق نفسه المستخدم في سمات القاموس. مثال:

<structure>
    <key>
        <attribute>
            <name>field1</name>
            <type>String</type>
        </attribute>
        <attribute>
            <name>field2</name>
            <type>UInt32</type>
        </attribute>
        ...
    </key>
...

أو

CREATE DICTIONARY (
    field1 String,
    field2 UInt32
    ...
)
PRIMARY KEY field1, field2
...

بالنسبة إلى استعلام للدالة dictGet*، تُمرَّر قيمة tuple كمفتاح. مثال: dictGetString('dict_name', 'attr_name', tuple('string for field1', num_for_field2)).

عندما يتكوّن المفتاح المركب من سمة واحدة، يمكن تمرير قيمة المفتاح مباشرةً، من دون تغليفها داخل tuple. على سبيل المثال، كلٌّ من dictGetString('dict_name', 'attr_name', 'key') و dictGetString('dict_name', 'attr_name', tuple('key')) صحيح.

مثال على التهيئة:

<structure>
    ...
    <attribute>
        <name>Name</name>
        <type>ClickHouseDataType</type>
        <null_value></null_value>
        <expression>rand64()</expression>
        <hierarchical>true</hierarchical>
        <injective>true</injective>
        <is_object_id>true</is_object_id>
    </attribute>
</structure>

أو

CREATE DICTIONARY somename (
    Name ClickHouseDataType DEFAULT '' EXPRESSION rand64() HIERARCHICAL INJECTIVE IS_OBJECT_ID
)

حقول الإعداد: