使用變數建立無限資料表 - Amazon Aurora
使用變數的範例Aurora PostgreSQL Limitless Database 資料表檢視

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用變數建立無限資料表

您可以設定資料表建立模式，使用變數來建立碎片和參考資料表。然後，您建立的資料表將使用此模式，直到設定不同的模式為止。

使用下列變數，來建立碎片和參考資料表：

  • rds_aurora.limitless_create_table_mode：將此工作階段變數設為 sharded 或 reference。此變數的預設值是 standard。

  • rds_aurora.limitless_create_table_shard_key：將此工作階段變數設為欄名稱陣列，以用作為碎片索引鍵。當 rds_aurora.limitless_create_table_mode 不是 sharded 時，會忽略此變數。

    將值格式化為 untyped array literal，類似於將常值插入陣列欄。如需詳細資訊，請參閱 PostgreSQL 文件中的陣列。

  • rds_aurora.limitless_create_table_collocate_with：將此工作階段變數設為特定資料表名稱，以將新建立的資料表與該資料表共置。

    如果使用相同的碎片索引鍵分割二或多個資料表，您可以將那些資料表明確對齊 (共置)。將二或多個資料表共置時，會將具有相同碎片索引鍵值的資料表中的列放置在相同的碎片。共置有助於將某些操作限制為單一碎片，進而獲得更好的效能。

注意

所有主要和唯一索引鍵都必須包含碎片索引鍵。這表示碎片索引鍵是主要或唯一索引鍵的子集。

無限資料表有一些限制。如需更多詳細資訊，請參閱 Aurora PostgreSQL Limitless Database 的 DDL 限制和其他資訊。

使用變數建立無限資料表的範例

下列範例示範如何使用這些變數來建立碎片和參考資料表。

使用碎片索引鍵 id 建立名為 items 的碎片資料表。

BEGIN;
SET LOCAL rds_aurora.limitless_create_table_mode='sharded';
SET LOCAL rds_aurora.limitless_create_table_shard_key='{"id"}';
CREATE TABLE items(id int, val int, item text);
COMMIT;

使用由 item_id 和 item_cat 欄組成的碎片索引鍵，建立名為 items 的碎片資料表。

BEGIN;
SET LOCAL rds_aurora.limitless_create_table_mode='sharded';
SET LOCAL rds_aurora.limitless_create_table_shard_key='{"item_id", "item_cat"}';
CREATE TABLE items(item_id int, item_cat varchar, val int, item text);
COMMIT;

使用由 item_id 和 item_cat 欄組成的碎片索引鍵，建立名為 item_description 的碎片資料表，並將其與上一個範例中的 items 資料表共置。

BEGIN;
SET LOCAL rds_aurora.limitless_create_table_mode='sharded';
SET LOCAL rds_aurora.limitless_create_table_shard_key='{"item_id", "item_cat"}';
SET LOCAL rds_aurora.limitless_create_table_collocate_with='items';
CREATE TABLE item_description(item_id int, item_cat varchar, color_id int);
COMMIT;

建立名為 colors 的參考資料表。

BEGIN;
SET LOCAL rds_aurora.limitless_create_table_mode='reference';
CREATE TABLE colors(color_id int primary key, color varchar);
COMMIT;

若要將 rds_aurora.limitless_create_table_mode 工作階段變數重設為 standard，請使用下列陳述式：

RESET rds_aurora.limitless_create_table_mode;

重設此變數之後，系統會將資料表建立為標準資料表，這是預設值。如需標準資料表的詳細資訊，請參閱將標準資料表轉換為無限資料表。

Aurora PostgreSQL Limitless Database 資料表檢視

您可以使用下列檢視，來尋找 Limitless Database 資料表的相關資訊。

rds_aurora.limitless_tables

rds_aurora.limitless_tables 檢視包含有關無限資料表及其類型的資訊。

postgres_limitless=> SELECT * FROM rds_aurora.limitless_tables;

 table_gid | local_oid | schema_name | table_name  | table_status | table_type  | distribution_key
-----------+-----------+-------------+-------------+--------------+-------------+------------------
         5 |     18635 | public      | standard    | active       | standard    | 
         6 |     18641 | public      | ref         | active       | reference   | 
         7 |     18797 | public      | orders      | active       | sharded     | HASH (order_id)
         2 |     18579 | public      | customer    | active       | sharded     | HASH (cust_id)
(4 rows)
rds_aurora.limitless_table_collocations

rds_aurora.limitless_table_collocations 檢視包含共置碎片資料表的相關資訊。例如，orders 和 customers 資料表是共置的，而且具有相同的 collocation_id。users 和 followers 資料表是共置的，而且具有相同的 collocation_id。

postgres_limitless=> SELECT * FROM rds_aurora.limitless_table_collocations ORDER BY collocation_id;

 collocation_id | schema_name | table_name
----------------+-------------+------------
          16002 | public      | orders
          16002 | public      | customers
          16005 | public      | users
          16005 | public      | followers
(4 rows)
rds_aurora.limitless_table_collocation_distributions

rds_aurora.limitless_table_collocation_distributions 會顯示每個共置的金鑰分佈。

postgres_limitless=> SELECT * FROM rds_aurora.limitless_table_collocation_distributions ORDER BY collocation_id, lower_bound;

 collocation_id | subcluster_id |     lower_bound      |     upper_bound
----------------+---------------+----------------------+----------------------
          16002 |             6 | -9223372036854775808 | -4611686018427387904
          16002 |             5 | -4611686018427387904 |                    0
          16002 |             4 |                    0 |  4611686018427387904
          16002 |             3 |  4611686018427387904 |  9223372036854775807
          16005 |             6 | -9223372036854775808 | -4611686018427387904
          16005 |             5 | -4611686018427387904 |                    0
          16005 |             4 |                    0 |  4611686018427387904
          16005 |             3 |  4611686018427387904 |  9223372036854775807
(8 rows)