ApsaraDB for SelectDB:Değişken yönetimi

SHOW VARIABLES;

SHOW VARIABLES LIKE '%time_zone%';

Oturum değişkeni ayarlama

Oturum değişkenleri hemen etkili olur ve yalnızca geçerli bağlantıya uygulanır:

SET exec_mem_limit = 137438953472;
SET forward_to_master = true;
SET time_zone = "Asia/Shanghai";

Değişkenler ayrıca sabit ifadeleri de kabul eder:

SET exec_mem_limit = 10 * 1024 * 1024 * 1024;
SET forward_to_master = concat('tr', 'u', 'e');

Global değişken ayarlama

Global değişkenler, geçerli oturum ve sonraki tüm oturumlar için etkili olur:

SET GLOBAL exec_mem_limit = 137438953472;

Aşağıdaki değişkenler hem oturum hem de global kapsamı destekler:

• time_zone

• wait_timeout

• sql_mode

• enable_profile

• query_timeout

• insert_timeout

• exec_mem_limit

• batch_size

• allow_partition_column_nullable

• insert_visible_timeout_ms

• enable_fold_constant_by_be

Aşağıdaki değişkenler yalnızca global kapsamı destekler:

• default_rowset_type

• default_password_lifetime

• password_history

• validate_password_policy

Tek bir sorgu için değişkeni geçersiz kılma

Oturum durumunu değiştirmeden tek bir ifade için oturum değişkeni ayarlamak üzere SET_VAR ipucunu kullanın:

SELECT /*+ SET_VAR(exec_mem_limit = 8589934592) */ name FROM people ORDER BY name;
SELECT /*+ SET_VAR(query_timeout = 1, enable_partition_cache=true) */ sleep(3);

Yorumlar /*+ ile başlamalı ve SELECT ifadesini takip etmelidir.

Saat dilimi değişkenlerini sorgulama ve ayarlama

Her iki saat dilimi değişkenini de görüntülemek için:

SHOW VARIABLES LIKE '%time_zone%';

Oturum saat dilimini ayarlamak için:

SET time_zone = 'Asia/Shanghai';

Sonraki tüm oturumlar için küme saat dilimini ayarlamak için:

SET GLOBAL time_zone = 'Asia/Shanghai';

Desteklenen saat dilimi formatları

Bazı veri içe aktarma yöntemleri, yukarıda listelenmeyen ek saat dilimi formatlarını kabul edebilir. Üretim ortamında standart olmayan formatlara güvenmeyin; ApsaraDB for SelectDB bunları işleme biçimini istediği zaman değiştirebilir.

Saat dilimi ayarlarının işlevleri ve verileri nasıl etkilediği

Etkilenen işlevler

Aşağıdaki işlevler, geçerli time_zone ayarına göre sonuç döndürür:

SHOW LOAD ve SHOW BACKENDS çıktısı da yapılandırılan saat dilimini yansıtır.

Saat dilimi ayarlarından etkilenmeyenler:

• CREATE TABLE içindeki zaman türü bölüm anahtarı sütunlarının less than değerleri

• DATE veya DATETIME türü olarak depolanan değerler (depolanan değerin kendisi değişmez)

İçe aktarma sırasında zaman türü veriler

DATE, DATEV2, DATETIME veya DATETIMEV2 türündeki verileri içe aktarırken ApsaraDB for SelectDB saat dilimi dönüşümünü aşağıdaki gibi işler:

• Saat dilimi sonekli veriler (örneğin, 2020-12-12 12:12:12+08:00): Kümenin geçerli time_zone değerine dönüştürülür. Örneğin, time_zone değeri +00:00 ise, depolanan değer 2020-12-12 04:12:12 olur.

• Saat dilimi soneki olmayan veriler (örneğin, 2020-12-12 12:12:12): Mutlak zaman olarak kabul edilir — dönüşüm yapılmadan olduğu gibi içe aktarılır.

Yaz saati uygulaması

Yaz saati uygulamaları ayarlamaları adlandırılmış saat dilimlerine gömülüdür. Örneğin, America/Los_Angeles Mart ayında -08:00 değerinden -07:00 değerine, Kasım ayında tekrar eski değerine geçer.

Yaz saati değişikliklerinden kaçınmak için, time_zone değerini America/Los_Angeles gibi adlandırılmış bir bölge yerine sabit bir UTC ofsetine (örneğin, -08:00) ayarlayın.

Saat dilimi veri kaynakları

Her backend (BE) düğümünde, ApsaraDB for SelectDB saat dilimi verilerini sırasıyla aşağıdaki konumlarda arar:

1. TZDIR komutu tarafından döndürülen dizin

2. /usr/share/zoneinfo

3. BE dağıtım dizinindeki zoneinfo dizini

Hiçbir konumda saat dilimi verisi bulunamazsa, BE düğümü başlatılamaz.

Saat dilimine duyarlı veriler

Verileri içe aktarmadan önce saat dilimi bilgilerinin tutarlı bir şekilde nasıl işleneceğine karar verin. DATETIME gibi zaman türündeki veriler bir saat dilimi depolamaz; ApsaraDB for SelectDB iki kategoriyi ayırt eder:

Mutlak zaman: Veride saat dilimi yoktur, içe aktarma sırasında saat dilimi yapılandırılmamıştır. Örnek: 2023-12-12 08:00:00. Olduğu gibi depolanır ve sorgulanır, time_zone değerinden etkilenmez.

Belirli bir saat dilimindeki zaman: Veri bir saat dilimi soneki içerir. Örnek: 2020-12-12 12:12:12+02:00. Hangi saat dilimi ayarının geçerli olacağı içe aktarma yöntemi tarafından belirlenir:

• INSERT INTO: time_zone oturum değişkeni tarafından yönetilir.

• Stream Load veya Broker Load: timezone istek üstbilgisi tarafından yönetilir. timezone üstbilgisi ile time_zone oturum değişkeni çakışırsa, timezone üstbilgisi önceliklidir.

ApsaraDB for SelectDB, gelen verilerdeki gerçek saat dilimini, içe aktarma sırasında time_zone ile yapılandırılan saat dilimine dönüştürür.

Önerilen yaklaşım: İçe aktarmadan önce time_zone değerini bir kez ayarlayın ve ardından tutarlı tutun. Saat dilimi farkındalığı olan verileri içe aktardıktan sonra time_zone değerini değiştirmek, depolanan değerlerin sonraki sorgularda yanlış yorumlanmasına neden olur.

Aşağıdaki örnek, time_zone değerinin oturum ortasında değiştirilmesi durumunda ne olduğunu gösterir:

-- Current time zone: Asia/Hong_Kong
SELECT @@time_zone;
-- +----------------+
-- | @@time_zone    |
-- +----------------+
-- | Asia/Hong_Kong |
-- +----------------+

-- Import data with literal time zone +02:00
-- Stored as 2020-12-12 18:12:12 (converted to Asia/Hong_Kong)
INSERT INTO dtv23 VALUES('2020-12-12 12:12:12+02:00');

SELECT * FROM dtv23;
-- +-------------------------+
-- | k0                      |
-- +-------------------------+
-- | 2020-12-12 18:12:12.000 |
-- +-------------------------+

-- Changing time_zone does not update stored values
SET time_zone = 'America/Los_Angeles';

-- A second import now uses America/Los_Angeles for conversion
INSERT INTO dtv23 VALUES('2020-12-12 12:12:12+02:00');

SELECT * FROM dtv23;
-- Rows now carry inconsistent time zone semantics
-- +-------------------------+
-- | k0                      |
-- +-------------------------+
-- | 2020-12-12 02:12:12.000 |  -- imported under America/Los_Angeles
-- | 2020-12-12 18:12:12.000 |  -- imported under Asia/Hong_Kong
-- +-------------------------+

Saat dilimi en iyi uygulamalarının özeti:

• Verileri içe aktarmadan önce kümenin time_zone değerini onaylayın ve sonrasında değiştirmeyin.

• Stream Load veya Broker Load kullanırken, timezone üstbilgisini time_zone oturum değişkeniyle aynı değere ayarlayın.

• Mutlak zaman verileri için saat dilimi soneki olmadan içe aktarın. Saat dilimi farkındalığı olan veriler için saat dilimi sonekini ekleyin ve dönüşümü ApsaraDB for SelectDB'nin işlemesine izin verin.

Yaz saati uygulaması doğruluğu

Adlandırılmış saat dilimi verileri (yaz saati uygulama başlangıç ve bitiş tarihleri dahil) Internet Assigned Numbers Authority (IANA) tarafından korunur. Her BE düğümünde depolanan veriler, IANA tarafından geçerli yıl için onaylanan en son değişiklikleri yansıtmayabilir.

İş yükünüz en son yaz saati uygulaması takvimini gerektiriyorsa, her BE düğümündeki saat dilimi veri kaynağının en son IANA tz veritabanı sürümünü içerdiğinden emin olun. En son veriler için bkz. The tz-announce Archives.

Desteklenen değişkenler