Tablestore:Use Function Compute

Adım 1: Tablestore Stream'i Etkinleştirme

Function Compute (FC) içindeki bir Tablestore tetikleyicisi, artımlı verileri yakalamak için Tablestore Stream'e dayanır. Bu nedenle, öncelikle hedef veri tablosu için bu özelliği etkinleştirmeniz gerekir.

Tablestore tetikleyicileri aşağıdaki bölgelerde kullanılabilir: Çin (Pekin), Çin (Hangzhou), Çin (Şanghay), Çin (Shenzhen), Japonya (Tokyo), Singapur, Almanya (Frankfurt) ve Çin (Hong Kong).

1. Tablestore konsolu üzerinde oturum açın. Üst gezinme çubuğunda örneğinizin bulunduğu bölgeyi seçin ve ardından hedef örneğin takma adına tıklayın.

2. Instance Details sayfasında, Tables listesindeki hedef veri tablosunun adına tıklayın.

3. Tunnels sekmesine tıklayın ve ardından Stream Information öğesinin sağ tarafındaki Enable seçeneğine tıklayın.

4. Enable Stream iletişim kutusunda günlük sona erme süresini ayarlayın ve ardından Enable seçeneğine tıklayın.

   Günlük sona erme süresi, en fazla 168 olacak şekilde saat cinsinden sıfır olmayan bir tamsayı olmalıdır. Bu ayar yapılandırıldıktan sonra değiştirilemez. Bu değeri dikkatle ayarlayın.

Adım 2: Olay İşlevi Oluşturma ve Yapılandırma

Bir Tablestore tetikleyicisi oluştururken yalnızca işlevle aynı bölgede bulunan Tablestore örneklerini ve veri tablolarını seçebilirsiniz.

1. Function Compute konsolu üzerinde oturum açın. Üst gezinme çubuğunda Tablestore örneğinizle aynı bölgeyi seçin.

2. Sol gezinme bölmesinde Function Management > Functions seçeneklerini belirleyin.

3. Create Function seçeneğine tıklayın, işlev türü olarak Event Function seçeneğini belirleyin ve ardından Create Event Function seçeneğine tıklayın.

4. İşlev parametrelerini aşağıda açıklandığı şekilde yapılandırın. Ayrıntılı talimatlar için bkz. Olay işlevi oluşturma.

   • Function Name: İşlev için benzersiz bir ad girin. Ad, aynı hesap ve bölge içinde benzersiz olmalı ve adlandırma kurallarına uymalıdır.

   • Runtime: Built-in Runtime seçeneğini belirlemeniz ve Python veya Java gibi aşina olduğunuz bir dil ve sürüm seçmeniz önerilir. Bu konuda örnek olarak Python 3.12 kullanılmıştır.

   • Code Upload Method: Kodunuzu yükleme yöntemini seçin. Bu konuda örnek olarak Upload ZIP kullanılmıştır. Örnek kod dosyasını indirip yükleyebilirsiniz: tablestore_trigger_example.zip.

5. Create seçeneğine tıklayın.

Adım 3: Olay İşlevini Test Etme ve Doğrulama

Tablestore tetikleyicisini yapılandırmadan önce, bir olayı simüle ederek işlevi test edin. Tablestore tetikleyicisi kodlama için Concise Binary Object Representation (CBOR) biçimini kullanır ancak hata ayıklama amacıyla olayları simüle etmek için JSON biçimini kullanabilirsiniz.

1. Function Details sayfasında, Test Function öğesinin yanındaki oku tıklayın ve Configure Test Parameters seçeneğini belirleyin.

2. Bir Event Name girin (örneğin, test-event), aşağıdaki örnek olayı düzenleyiciye yapıştırın ve ardından OK seçeneğine tıklayın.

   {
       "Version": "Sync-v1",
       "Records": [
           {
               "Type": "PutRow",
               "Info": {
                   "Timestamp": 1506416585740836
               },
               "PrimaryKey": [
                   {
                       "ColumnName": "pk_0",
                       "Value": 1506416585881590900
                   },
                   {
                       "ColumnName": "pk_1",
                       "Value": "2017-09-26 17:03:05.8815909 +0800 CST"
                   },
                   {
                       "ColumnName": "pk_2",
                       "Value": 1506416585741000
                   }
               ],
               "Columns": [
                   {
                       "Type": "Put",
                       "ColumnName": "attr_0",
                       "Value": "hello_table_store",
                       "Timestamp": 1506416585741
                   },
                   {
                       "Type": "Put",
                       "ColumnName": "attr_1",
                       "Value": 1506416585881590900,
                       "Timestamp": 1506416585741
                   }
               ]
           }
       ]
   }

3. Test Function seçeneğine tıklayın ve testin tamamlanmasını bekleyin. Başarılı bir çalıştırma OK döndürür. Çalıştırma günlüklerini Log Output sekmesinde görüntüleyebilirsiniz.

   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Begin to handle event
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] --------------------------------------------------
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Event Type: PutRow
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Timestamp: 1506416585740836
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Primary Keys:
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Name: pk_0, Value: 1506416585881590900
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Name: pk_1, Value: 2017-09-26 17:03:05.8815909 +0800 CST
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Name: pk_2, Value: 1506416585741000
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Attribute Columns:
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Type: Put, Name: attr_0, Value: hello_table_store, Timestamp: 1506416585741
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Type: Put, Name: attr_1, Value: 1506416585881590900, Timestamp: 1506416585741
   2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] --------------------------------------------------

Adım 4: Tetikleyiciyi Yapılandırma ve Doğrulama

İşlevi test edip doğruladıktan sonra, veri tablosu değiştiğinde işlevi otomatik olarak yürütmek için Tablestore tetikleyicisini yapılandırın. Ardından, bir veri işlemi gerçekleştirerek tetikleyiciyi doğrulayın.

1. Function Details sayfasında Triggers sekmesine tıklayın ve ardından Create Trigger seçeneğine tıklayın.

2. Tetikleyici parametrelerini aşağıdaki gibi yapılandırın.

   • Trigger Type: Tablestore seçeneğini belirleyin.

   • Name: Tetikleyici için özel bir ad girin (örneğin, test_trigger).

   • Instance: Hedef Tablestore örneğini seçin.

   • Table: Hedef veri tablosunu seçin.

3. OK seçeneğine tıklayın.

4. Örneğin, Tablestore konsolu kullanarak bir satır ekleyebilirsiniz.

5. Function Details sayfasında Logs sekmesine tıklayarak çağrı günlüklerini ve sonuçlarını görüntüleyin. Belirli bir isteğin ayrıntılı günlüklerini görüntülemek için Actions sütununda Request Logs seçeneğine tıklayın.

   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Begin to handle event
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] --------------------------------------------------
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Event Type: PutRow
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Timestamp: 1763973009228992
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Primary Keys:
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO]   Name: id, Value: 8
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO]   Name: name, Value: test-name
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Attribute Columns:
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO]   Type: Put, Name: age, Value: 18, Timestamp: 1763973009229
   2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] --------------------------------------------------