Tablestore：Gunakan filter

Prasyarat

• Sebuah instance OTSClient telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi instance OTSClient.

• Tabel data telah dibuat dan data telah ditulis ke dalam tabel tersebut. Untuk informasi lebih lanjut, lihat Buat tabel data dan Tulis data.

Metode

Saat menggunakan operasi GetRow, BatchGetRow, atau GetRange untuk menanyakan data, Anda dapat menerapkan filter agar hanya baris yang memenuhi kondisi tertentu yang dikembalikan.

Filter mencakup SingleColumnValueFilter dan CompositeColumnValueFilter.

• SingleColumnValueFilter: Menentukan apakah baris akan dikembalikan berdasarkan nilai dari kolom referensi.

• CompositeColumnValueFilter: Menentukan apakah baris akan dikembalikan berdasarkan kombinasi kondisi filter dari beberapa kolom referensi.

Catatan penggunaan

• Kondisi filter mendukung operator relasional berikut: =, !=, >, >=, <, dan <=. Kondisi filter juga mendukung operator logika NOT, AND, dan OR. Anda dapat menentukan hingga 10 subkondisi dalam sebuah kondisi filter.

• Kolom referensi yang digunakan oleh filter harus termasuk dalam kolom yang dikembalikan. Jika tidak, filter tidak dapat menanyakan nilai dari kolom referensi.

• Penggunaan filter pada operasi GetRow, BatchGetRow, dan GetRange tidak mempengaruhi semantik asli atau batasan dari operasi tersebut.

  Saat menggunakan operasi GetRange, hingga 5.000 baris atau 4 MB data dapat dipindai dalam satu waktu.

  Jika data yang dipindai tidak sesuai dengan kondisi filter, respons baris akan kosong. Namun, parameter next_start_primary_key mungkin tetap ada. Jika parameter ini tidak kosong, gunakan nilainya untuk melanjutkan pemindaian sampai NextStartPrimaryKey kosong.

Parameter

Anda dapat mengonfigurasi parameter column_filter untuk menggunakan filter dalam operasi GetRow, BatchGetRow, dan GetRange.

    'column_filter' => <ColumnFilter>

• SingleColumnValueFilter

  SingleColumnValueFilter memungkinkan Anda membandingkan kolom dengan konstanta. Perbandingan antara dua kolom atau dua konstanta tidak didukung.

      [
          'column_name' => '<string>',
          'value' => <ColumnValue>,
          'comparator' => <ComparatorType>,
          'pass_if_missing' => true || false,
          'latest_version_only' => true || false
      ]
          

• CompositeColumnValueFilter

  CompositeColumnValueFilter memiliki struktur pohon, terdiri dari node logical_operator dan node daun SingleColumnValueFilter.

      [
          'logical_operator' => <LogicalOperator>
          'sub_filters' => [
              <ColumnFilter>,
              <ColumnFilter>,
              <ColumnFilter>,
              // kondisi lainnya
          ]
      ]
          

Contoh

$request = [
    'table_name' => 'MyTable',
    'primary_key' => [ // Tentukan primary key. 
        ['PK0', 123],
        ['PK1', 'abc']
    ],
    'max_versions' => 1,                     // Setel parameter ini ke 1 untuk membaca data versi terbaru. 
    'columns_to_get' => ['Col0']             // Tentukan kolom yang ingin Anda baca. 
    
    // Tentukan filter untuk mengembalikan baris jika nilai kolom Col0 adalah 0. 
    'column_filter' => [
        'column_name' => 'col0',
        'value' => 0,
        'comparator' => ComparatorTypeConst::CONST_EQUAL,
        'pass_if_missing' => false                         / Jika kolom Col0 tidak ada dalam baris, baris tersebut tidak dikembalikan. 
        'latest_version_only' => true                      // Tentukan bahwa hanya versi terbaru yang digunakan untuk perbandingan. 
    ]
];
$response = $otsClient->getRow ($request); 

// Atur kondisi composite1 menjadi (Col0 == 0) AND (Col1 > 100). 
    $composite1 = [
        'logical_operator' => LogicalOperatorConst::CONST_AND,
        'sub_filters' => [
            [
                'column_name' => 'Col0',
                'value' => 0,
                'comparator' => ComparatorTypeConst::CONST_EQUAL
            ],
            [
                'column_name' => 'Col1',
                'value' => 100,
                'comparator' => ComparatorTypeConst::CONST_GREATER_THAN
            ]
        ]
    ];
    // Atur kondisi composite2 menjadi ( (Col0 == 0) AND (Col1 > 100) ) OR (Col2 <= 10). 
    $composite2 = [
        'logical_operator' => LogicalOperatorConst::CONST_OR,
        'sub_filters' => [
            $composite1,
            [
                'column_name' => 'Col2',
                'value' => 10,
                'comparator' => ComparatorTypeConst::CONST_LESS_EQUAL
            ]
        ]
    ];  
                    

Referensi

• Jika aplikasi perlu menggunakan kolom atribut yang berbeda sebagai kondisi kueri, Anda dapat menentukan kolom atribut ini sebagai kolom primary key dari indeks sekunder untuk mempercepat kueri data. Untuk informasi lebih lanjut, lihat Indeks Sekunder.

• Jika bisnis Anda memerlukan kueri multi-dimensi dan analisis data, Anda dapat membuat indeks pencarian dan menentukan kolom atribut yang diperlukan sebagai bidang dari indeks pencarian. Kemudian, Anda dapat menanyakan dan menganalisis data menggunakan indeks pencarian. Sebagai contoh, Anda dapat menggunakan indeks pencarian untuk melakukan kueri berdasarkan kolom non-primary key, kueri Boolean, dan kueri fuzzy. Anda juga dapat menggunakan indeks pencarian untuk mendapatkan nilai maksimum dan minimum, mengumpulkan statistik jumlah baris, dan mengelompokkan hasil kueri. Untuk informasi lebih lanjut, lihat Indeks Pencarian.

• Anda dapat menggunakan fitur kueri SQL untuk menanyakan dan menganalisis data dalam tabel. Untuk informasi lebih lanjut, lihat Kueri Data.