Tüm Ürünler
Search
Belge Merkezi

PolarDB:Instructions

Son Güncelleme:Oct 07, 2026

Kümenizi Hibrit İşlemsel/Analitik İşleme (HTAP) iş yükleri için yapılandırmak üzere Hızlı başlangıç bölümüne bakın veya IMCI'yi özel iş gereksinimlerinize göre özelleştirmek için Gelişmiş kullanım bölümünü inceleyin.

Hızlı başlangıç

Adım 1: Salt okunur bir IMCI düğümü ekleyin

PolarDB konsolunda oturum açın. Sol gezinme bölmesinde Cluster List seçeneğine tıklayın. Kümenizin bölge değerini seçin ve ilgili kümeyi bulun. Actions sütununda, salt okunur bir IMCI düğümü eklemek için Add/Remove Node seçeneğine tıklayın.

Not

Adım 2: İstek yönlendirmeyi yapılandırın

İş gereksinimlerinize bağlı olarak IMCI'yi kullanmak için otomatik veya manuel istek yönlendirmeyi seçebilirsiniz.

  • Otomatik istek yönlendirme: Çevrimiçi İşlemsel İşleme (OLTP) ve Çevrimiçi Analitik İşleme (OLAP) iş yükleriniz veritabanına aynı uygulamadan erişiyorsa, taranan satır sayısına göre belirlenen tahmini yürütme maliyetine dayanarak okuma isteklerini otomatik olarak salt okunur IMCI düğümlerine veya salt okunur satır deposu düğümlerine yönlendirebilirsiniz.

  • Manuel istek yönlendirme: OLTP ve OLAP iş yükleriniz veritabanına farklı uygulamalardan erişiyorsa, bu uygulamalar için farklı küme uç noktaları yapılandırabilirsiniz. Ardından, salt okunur IMCI düğümlerini ve salt okunur satır deposu düğümlerini farklı uç noktaların hizmet düğümlerine atayarak istekleri satır ve sütun depolarına yönlendirebilirsiniz.

Otomatik istek yönlendirme

Küme ayrıntıları sayfasında Database Connections bölümüne gidin. Cluster Endpoint için Row Store/Column Store Automatic Routing ayarını Enable olarak değiştirin.

Not
  • **Service Node üzerinde yapılan değişiklikler yalnızca yeni bağlantılar için geçerlidir. Değişikliği yaptıktan sonra kümeye yeniden bağlanın.**

  • Kümeye DMS kullanarak bağlanıyorsanız, DMS'nin varsayılan olarak Primary address kullandığını unutmayın. PolarDB kümesine bağlanmak için küme uç noktasını kullanmanız gerekir.

  • Otomatik istek yönlendirme için varsayılan tahmini yürütme maliyeti eşiği 50.000 taranan satırdır. Bu parametreyi iş gereksinimlerinize göre ayarlayabilirsiniz.

Manuel istek yönlendirme

Küme ayrıntıları sayfasında Database Connections bölümüne gidin ve özel bir uç nokta oluşturun. Service Node listesinin yalnızca read-only IMCI nodes içerdiğinden emin olun.

Adım 3: Bir IMCI ekleyin

İş gereksinimlerinize göre tablolarınıza IMCI'leri manuel veya otomatik olarak ekleyebilirsiniz.

Önemli

Bir sorgunun IMCI tarafından hızlandırılması için, SQL ifadesinde başvurulan tüm sütunların bir IMCI tarafından tamamen kapsanması gerekir.

Manuel

IMCI, iş tabloları için IMCI eklemek veya kaldırmak amacıyla eksiksiz bir DDL deyimi seti sağlar. İhtiyaçlarınıza uygun seçeneği belirleyin:

DDL sözdizimi

Örnek

Tablo oluştururken bir IMCI ekleyin

-- Add an IMCI for a specific column.
CREATE TABLE <table_name>(
  <column_name_1> INT COMMENT 'COLUMNAR=1',
  <column_name_2> VARCHAR(100)
) ENGINE InnoDB;

-- Add an IMCI for the entire table.
CREATE TABLE <table_name>(
  <column_name_1> INT,
  <column_name_2> VARCHAR(100)
) ENGINE InnoDB COMMENT 'COLUMNAR=1';

Dinamik olarak bir IMCI ekleyin veya kaldırın

-- Add an IMCI for a specific column.
ALTER TABLE <table_name> MODIFY COLUMN <column_name_1> INT COMMENT 'COLUMNAR=1';
               
-- Add an IMCI for the entire table.
ALTER TABLE <table_name> COMMENT 'COLUMNAR=1';

Veritabanı veya tablo düzeyinde toplu iş olarak IMCI ekleyin veya kaldırın

-- Add an IMCI for the entire table.
CREATE COLUMNAR INDEX ON <db_name>.<table_name>;

-- Add IMCIs for all tables in a database.
CREATE COLUMNAR INDEX FOR TABLES IN <db_name>;
Not
  • Bir IMCI eklerken mevcut açıklamaları koruyabilirsiniz. Örnek: ALTER TABLE <table_name> COMMENT 'COLUMNAR=1 <original comment>';.

  • Varsayılan olarak, veritabanı veya tablo düzeyinde toplu iş olarak bir IMCI eklediğinizde tablo açıklaması 'COLUMNAR=1 <original comment>' şeklinde güncellenir.

Otomatik

AutoIndex özelliği, yavaş sorgularınıza dayanarak otomatik olarak IMCI'ler oluşturabilir ve bunların yürütme hızını önemli ölçüde artırabilir. Bu sayede her bir yavaş sorguyu anlamak ve optimize etmek zorunda kalmazsınız. Uygulama iş yükü değiştikçe AutoIndex, PolarDB kümenizin en iyi performansı sürdürmesini sağlamak için IMCI stratejisini sürekli olarak izler ve ayarlar.

Bu özelliğin avantajlarından yararlanmak için PolarDB küme ayrıntıları sayfasında AutoIndex'i basitçe Enable etmeniz yeterlidir:

Configuration bölümünde, varsayılan olarak Disabled olan AutoIndex öğesini bulun ve sağ tarafındaki Enable seçeneğine tıklayın.

(İsteğe Bağlı) Adım 4: IMCI oluşturma ilerlemesini kontrol edin

Manuel olarak bir IMCI ekledikten sonra oluşturma ilerlemesini kontrol edin. Sorgu hızlandırmadan yararlanmak için oluşturma işleminin tamamlanmasını bekleyin.

SELECT * FROM INFORMATION_SCHEMA.IMCI_ASYNC_DDL_STATS;

Örnek: IMCI'nin tamamen oluşturulduğunu onaylamak için STATUS sütunundaki değerin Safe to read olup olmadığını kontrol edin.

+-------------+------------+---------------------+---------------------+---------------------+--------------+------------------+-----------------+-------------+-------------+-------------+------------+--------------+-----------+-------------------+-----------------+
| SCHEMA_NAME | TABLE_NAME | CREATED_AT          | STARTED_AT          | FINISHED_AT         | STATUS       | APPROXIMATE_ROWS | SCANNED_ROWS    | SCAN_SECOND | SORT_ROUNDS | SORT_SECOND | BUILD_ROWS | BUILD_SECOND | AVG_SPEED | SPEED_LAST_SECOND | ESTIMATE_SECOND |
+-------------+------------+---------------------+---------------------+---------------------+--------------+------------------+-----------------+-------------+-------------+-------------+------------+--------------+-----------+-------------------+-----------------+
| tpch        | lineitem   | 2024-10-21 13:44:02 | 2024-10-21 13:44:02 | 2024-10-21 13:50:11 | Safe to read | 590446240        | 600037902(100%) | 369         | 0           | 0           | 0(0%)      | 0            | 1625058   | 0                 | 0               |
+-------------+------------+---------------------+---------------------+---------------------+--------------+------------------+-----------------+-------------+-------------+-------------+------------+--------------+-----------+-------------------+-----------------+
1 row in set, 1 warning (0.00 sec)

(İsteğe Bağlı) Adım 5: IMCI kullanımını kontrol edin

Bir IMCI yürütme planı yatay bir ağaç olarak görüntülenir ve satır deposu yürütme planından belirgin şekilde farklı bir biçime sahiptir. Yürütme planını görüntülemek ve bir SQL ifadesinin IMCI tarafından hızlandırılabileceğini belirlemek için EXPLAIN ifadesini kullanabilirsiniz. Aşağıdaki örneklerde bu fark gösterilmektedir:

IMCI yürütme planı

+----+----------------------------+----------+--------+--------+-----------------------------------------------------------------------------+
| ID | Operator                   | Name     | E-Rows | E-Cost | Extra Info                                                                  |
+----+----------------------------+----------+--------+--------+-----------------------------------------------------------------------------+
|  1 | Select Statement           |          |        |        | IMCI Execution Plan (max_dop = 4, max_query_mem = 858993459)                |
|  2 | └─Sort                     |          |        |        | Sort Key: revenue DESC,o_orderdate ASC                                      |
|  3 |   └─Hash Groupby           |          |        |        | Group Key: (lineitem.L_ORDERKEY, orders.O_ORDERDATE, orders.O_SHIPPRIORITY) |
|  4 |     └─Hash Join            |          |        |        | Join Cond: orders.O_ORDERKEY = lineitem.L_ORDERKEY                          |
|  5 |       ├─Hash Join          |          |        |        | Join Cond: customer.C_CUSTKEY = orders.O_CUSTKEY                            |
|  6 |       │ ├─Table Scan       | customer |        |        | Cond: (C_MKTSEGMENT = "BUILDING")                                           |
|  7 |       │ └─Table Scan       | orders   |        |        | Cond: (O_ORDERDATE < 03/24/1995)                                            |
|  8 |       └─Table Scan         | lineitem |        |        | Cond: (L_SHIPDATE > 03/24/1995)                                             |
+----+----------------------------+----------+--------+--------+-----------------------------------------------------------------------------+
8 rows in set (0.01 sec)

Satır deposu yürütme planı

+----+-------------+----------+------------+------+--------------------+------------+---------+-----------------------------+--------+----------+----------------------------------------------+
| id | select_type | table    | partitions | type | possible_keys      | key        | key_len | ref                         | rows   | filtered | Extra                                        |
+----+-------------+----------+------------+------+--------------------+------------+---------+-----------------------------+--------+----------+----------------------------------------------+
|  1 | SIMPLE      | customer | NULL       | ALL  | PRIMARY            | NULL       | NULL    | NULL                        | 147630 |    10.00 | Using where; Using temporary; Using filesort |
|  1 | SIMPLE      | orders   | NULL       | ref  | PRIMARY,ORDERS_FK1 | ORDERS_FK1 | 4       | tpch100g.customer.C_CUSTKEY |     14 |    33.33 | Using where                                  |
|  1 | SIMPLE      | lineitem | NULL       | ref  | PRIMARY            | PRIMARY    | 4       | tpch100g.orders.O_ORDERKEY  |      4 |    33.33 | Using where                                  |
+----+-------------+----------+------------+------+--------------------+------------+---------+-----------------------------+--------+----------+----------------------------------------------+
3 rows in set, 1 warning (0.00 sec)

Yardımcı araçlar

Karmaşık SQL ifadelerini sorgulamak için IMCI'yi kullanırken, SQL ifadesindeki herhangi bir sütunun bir IMCI tarafından kapsanıp kapsanmadığını kontrol etmeniz gerekir. Kapsanmamış sütunlar bulursanız, SQL ifadesi için bir IMCI oluşturmak üzere DDL deyimlerini alabilir veya belirli bir iş yükü için IMCI'ler oluşturmak üzere DDL deyimlerini toplu iş olarak alabilirsiniz. DDL deyimlerini çalıştırdıktan sonra, sorgu hızlandırmayı etkinleştirmek için SQL ifadesinde başvurulan tüm sütunların bir IMCI tarafından kapsandığından emin olun.

PolarDB aşağıdaki yerleşik saklı yordamları sağlar:

SSS

Sorgu IMCI kullanmıyor

Salt okunur bir IMCI düğümü ekledikten sonra, SQL ifadesinde sorgulanan tüm tablolar için ayrıca bir IMCI oluşturmanız gerekir. İfade, yalnızca tahmini yürütme maliyeti belirli bir eşiği aştığında bir IMCI kullanır. Ayrıca, SQL ifadesinin hızlandırılması için bir salt okunur IMCI düğümüne iletilmesi gerekir. Bir SQL ifadesi IMCI kullanmıyorsa sorunu gidermek için şu adımları izleyin:

  1. SQL ifadesinin bir salt okunur IMCI düğümüne iletildiğini onaylayın.

    • Veritabanı uç noktası için Service Node listesinin bir salt okunur IMCI düğümü içerip içermediğini kontrol edin.

    • SQL ifadesinin bir salt okunur IMCI düğümüne iletildiğini onaylamak için SQL Explorer'ı kullanın.

    Service Node özelliği etkinleştirilmiş bir Cluster Endpoint kullanıyorsanız ve SQL ifadesinin tahmini yürütme maliyeti loose_imci_ap_threshold veya loose_cost_threshold_for_imci eşik değerinden yüksekse PolarProxy, SQL ifadesini bir salt okunur IMCI düğümüne iletir. SQL ifadesinin bir salt okunur IMCI düğümüne yönlendirilmesini zorlamak için SELECT anahtar sözcüğünden önce HINT sözdizimi /*FORCE_IMCI_NODES*/ ekleyebilirsiniz. Daha fazla bilgi için Otomatik yönlendirme eşik değerini yapılandırma konusuna bakın. Örnek:

    Veritabanı altyapısı küçük sürüm 8.0.1.1.39 ve 8.0.2.2.23 ve sonraki sürümlerde loose_imci_ap_threshold parametresi kullanımdan kaldırılmış ve yerine loose_cost_threshold_for_imci parametresi getirilmiştir.
    /*FORCE_IMCI_NODES*/EXPLAIN SELECT COUNT(*) FROM t1 WHERE t1.a > 1;
    Yeni bir veritabanı uç noktası oluşturmak, SQL ifadelerinin her zaman yürütülme için salt okunur IMCI düğümlerine yönlendirilmesini sağlar. Daha fazla bilgi için Yeni bir veritabanı uç noktası oluşturma konusuna bakın.
  2. **SQL ifadesinin tahmini yürütme maliyetinin yapılandırılan eşiği aşıp aşmadığını kontrol edin.**

    Bir salt okunur IMCI düğümünde, iyileştirici bir SQL ifadesinin yürütme maliyetini tahmin eder. Tahmini yürütme maliyeti, loose_imci_ap_threshold veya loose_cost_threshold_for_imci tarafından ayarlanan eşiği aşarsa iyileştirici bir IMCI kullanır. Aksi takdirde mevcut satır tabanlı dizinleri kullanır.

    Bir SQL ifadesinin bir salt okunur IMCI düğümüne iletildiğini onayladıktan sonra, EXPLAIN kullanılarak görüntülenen yürütme planı hala IMCI kullanmıyorsa, IMCI'nin tahmini yürütme maliyeti çok düşük olduğu için kullanılmadığını belirlemek üzere tahmini yürütme maliyetini önceden ayarlanmış eşikle karşılaştırabilirsiniz. Önceki SQL ifadesinin tahmini yürütme maliyetini elde etmek için Last_query_cost_for_imci değişkenini sorgulayabilirsiniz:

    -- Use EXPLAIN to view the execution plan of the SQL statement.
    EXPLAIN SELECT * FROM t1;
    -- Get the estimated execution cost of the previous query.
    SHOW STATUS LIKE 'Last_query_cost_for_imci';
    Veritabanına bağlanmak için bir küme uç noktası kullanıyorsanız, önceki ifadenin tahmini yürütme maliyetini doğru düğümde sorgulayabilmenizi sağlamak için SHOW STATUS LIKE 'Last_query_cost_for_imci' ifadesinden önce HINT sözdizimi /*ROUTE_TO_LAST_USED*/ eklemeniz önerilir. Örneğin, /*ROUTE_TO_LAST_USED*/SHOW STATUS LIKE 'Last_query_cost_for_imci';

    SQL ifadesinin tahmini yürütme maliyeti yapılandırılan eşikten düşükse, loose_imci_ap_threshold veya loose_cost_threshold_for_imci değerini ayarlamayı düşünün. Örneğin, tek bir SQL ifadesi için eşiği ayarlamak amacıyla bir HINT kullanabilirsiniz:

    /*FORCE_IMCI_NODES*/EXPLAIN SELECT /*+ SET_VAR(cost_threshold_for_imci=0) */ COUNT(*) FROM t1 WHERE t1.a > 1;
  3. SQL ifadesindeki tüm tabloların ve sütunların bir IMCI tarafından tamamen kapsandığını doğrulayın.

    Bir SQL ifadesindeki tablolar veya sütunlar için bir IMCI oluşturulup oluşturulmadığını kontrol etmek amacıyla dbms_imci.check_columnar_index('<query_string>') yerleşik saklı yordamını çağırabilirsiniz. Daha fazla bilgi için Bir SQL ifadesindeki tablolar veya sütunlar için bir IMCI oluşturulup oluşturulmadığını kontrol edin konusuna bakın. Örnek:

    CALL dbms_imci.check_columnar_index('SELECT COUNT(*) FROM t1 WHERE t1.a > 1');

    SQL ifadesi bir IMCI tarafından tamamen kapsanmıyorsa, bu saklı yordamı çağırmak kapsanmamış tabloları ve sütunları döndürür. Döndürülen her tablo ve sütun için bir IMCI oluşturmanız gerekir. İfade tamamen kapsanıyorsa yordam boş bir sonuç kümesi döndürür.

  4. Desteklenmeyen SQL özelliklerini kontrol edin.

    Belirli bir SQL özelliğinin IMCI'yi destekleyip desteklemediğini onaylamak için IMCI sözdizimi kullanım sınırlamalarını kontrol edin. Daha fazla bilgi için IMCI sözdizimi kullanım sınırlamaları konusuna bakın.

Yukarıdaki kontrolleri gerçekleştirdikten sonra SQL ifadesi hala bir IMCI kullanmıyorsa yardım almak için kullanım kılavuzuna bakabilir veya bizimle iletişime geçebilirsiniz .

Daha fazla bilgi için IMCI SSS konusuna bakın.

Gelişmiş kullanım

IMCI kullanımınızı optimize etmek için aşağıdaki konulara bakın.

Gelişmiş özellik

Açıklama

Bir IMCI için sıralama anahtarı ayarlama

IMCI, verileri satır gruplarına düzenler. Her satır grubunda farklı sütunlar sütun veri bloklarına paketlenir. Bu bloklar, orijinal satır tabanlı verilerin birincil anahtar sırasına göre paralel olarak oluşturulur ve bu durum genel olarak sırasız bir duruma neden olur. Sorgu performansını artırmak için sütun veri bloklarını yeniden sıralamak üzere bir sıralama anahtarı yapılandırabilirsiniz.

JSON verilerini verimli bir şekilde analiz etme

IMCI, büyük ölçekli yapılandırılmış ve yarı yapılandırılmış veri analitiğini işlemek amacıyla sütun tabanlı JSON, sanal sütunlar, Anlık DDL ve sütun sayısı genişletme gibi bir dizi özelliği entegre eder.

ETL işlemlerini IMCI ile hızlandırma

Extract, Transform, Load (ETL) özelliği, bir okuma-yazma (RW) düğümünde IMCI kullanmanıza olanak tanır. RW düğümünde verilen SELECT istekleri, hızlandırılmış sorgular için bir salt okunur IMCI düğümüne gönderilir. Veriler okunduktan sonra sistem, bunları dahili ağ üzerinden RW düğümüne aktarır ve hedef tabloya yazar.

Salt okunur IMCI düğümleri için Serverless'i etkinleştirme

Serverless özelliği, iş yükünüze göre kaynakları otomatik olarak yukarı ve aşağı ölçeklendirir. Yoğunluk sırasında iş yükü artışlarını karşılamak için ölçeği yukarı çıkarır ve maliyetleri azaltmak için yoğun olmayan saatlerde ölçeği aşağı indirir.

Hybrid Plan ile geniş tablo sorgularını hızlandırma

Hybrid Plan, aynı sorguda hem sütun hem de satır dizinlerini kullanır. Hybrid Plan, geniş tablo sorgu performansını önemli ölçüde artırabilir. Yürütme planında, sütun dizinlerinden yararlanan bölümler IMCI üzerinde çalıştırılır ve yalnızca birincil anahtarları içeren ara sonuçlar üretir. Ardından, gereken sütunlar InnoDB birincil dizini ile birincil anahtarlar kullanılarak getirilir ve döndürülür.

Çok düğümlü MPP ile büyük veri analizini hızlandırma

Büyük veriler üzerindeki karmaşık sorgular için tek bir salt okunur IMCI düğümü performans gereksinimlerini karşılamayabilir. Sorguları hızlandırmak için çok düğümlü paralel işlemeyi (MPP) kullanabilirsiniz.

Daha fazla bilgi

IMCI'nin arkasındaki ilkeler hakkında daha fazla bilgi edinmek için aşağıdaki belgelere bakın: