🐘OID <-> 🚀table_id

YugabyteDB 웹 콘솔 또는 일부 yb-admin 출력을 보면 table_id 또는 uuid 로 식별되는 YSQL 테이블을 볼 수 있습니다. 다음은 예입니다.


이 테이블 ID는 YSQL 테이블 또는 인덱스 이름이 "테이블 이름"으로 표시되고 YSQL 데이터베이스가 "키스페이스"로 표시되더라도 테이블, 인덱스 또는 파티션을 식별하기에 충분하지 않기 때문에 중요합니다. DocDB의 저장소는 모든 API에 공통이기 때문입니다. YSQL 스키마 또는 관계 유형을 모릅니다. 그리고 YCQL 테이블도 있습니다.

테이블 OID

위의 스크린샷에서 "Table OID"가 표시되기 때문에 YSQL 테이블을 쉽게 식별할 수 있습니다. 이 예에서 테이블 00004001000030008000000000004002은 OID가 categories인 yb_demo_northwind 데이터베이스의 16386 테이블임을 알 수 있습니다.

yugabyte=# \c yb_demo_northwind

psql (13.5, server 11.2-YB-2.13.1.0-b0)
You are now connected to database "yb_demo_northwind" as user "yugabyte".

select
 current_database(), schema, relname, relkind, am, owner, tablespace
from (                     -- pg_class -> table or index
select relkind, relname, relnamespace, reltype, relowner, relam, reltablespace from pg_class
where oid=16386
) as c natural left join ( -- pg_namespace -> schema
select oid relnamespace, nspname as schema from pg_namespace
) as n natural left join ( -- pg_authid -> owner
select oid relowner, rolname as owner from pg_authid
) as o natural left join ( -- pg_am -> access method
select oid relam, amname am from pg_am
) as a natural left join ( -- spcname pg_tablespace -> tablespace
select oid reltablespace, spcname as tablespace from pg_tablespace
) as t;

 current_database  | schema |  relname   | relkind | am |  owner   | tablespace
-------------------+--------+------------+---------+----+----------+------------
 yb_demo_northwind | public | categories | r       |    | yugabyte |

UUID

그러나 YSQL 테이블에서 table_id를 찾아야 할 수도 있습니다. 이것은 키스페이스(YSQL의 경우 PostgreSQL 데이터베이스)와 테이블(YSQL의 경우 관계의 PostgreSQL OID 포함)에서 빌드된 UUID입니다.

위의 내 table_id: 00004001000030008000000000004002를 분해하여 빌드 방법을 이해해 봅시다.

00004001-0000-3000-8000-000000004002 
    ^^^^                                -> PostgreSQL Database OID
              ^                         -> UUID Version 3 = name based MD5
                   ^                    -> UUID Variant = DCE 1.1, ISO/IEC
                                ^^^^    -> PostgreSQL Relation OID

code은 Postgres oids를 포함하기 위해 이전 이름 ​​기반 UUID v3의 용도 변경이라고 설명합니다.

OID

다음은 현재 search_path로 찾은 현재 데이터베이스의 내 table_id 테이블에 대해 PostgreSQL에서 categories를 얻는 방법입니다.

yb_demo_northwind=#

select format('0000%s00003000800000000000%s'
 ,lpad(to_hex(oid::int), 4, '0')
 ,lpad(to_hex('categories'::regclass::oid::int),4,'0')
 ) table_id from pg_database where datname=current_database()

             table_id
----------------------------------
 00004001000030008000000000004002
(1 row)

예를 들어 태블릿 정의를 http://yb-tmaster-0:7000/table?id=00004001000030008000000000004002로 직접 가져오기 위해 이것을 사용합니다.

이 엔드포인트는 keyspace_name 대신 table_id 및 id가 있는 태블릿도 찾을 수 있지만 스키마가 없는 YCQL에서만 작동합니다.

yb 관리자

테이블 ID를 아는 것은 UUID에 yb-admin 접두어를 붙이는 tableid. 명령에도 유용합니다.

$ /home/opc/yugabyte-2.13.1.0/bin/yb-admin list_tablets  tableid.00004001000030008000000000004002

Tablet-UUID                             Range                                                           Leader-IP               Leader-UUID
e4216871ffd644c3b616d37668400212        partition_key_start: "" partition_key_end: "UU"                 10.0.0.61:9100          1e6aa7f085d146e8b29207483592116a
85f1061e6f10410888cbbf6418d7047c        partition_key_start: "UU" partition_key_end: "\252\252"         10.0.0.63:9100          9eec605aede445e98ad61bf833dbf6cc
2884fe988f304591b2905e5272a571f9        partition_key_start: "\252\252" partition_key_end: ""           10.0.0.62:9100          4729e36c42934175817c580b52ea6a18

list_tablets는 키스페이스에 ysql. 접두사를 추가하여 YSQL 테이블 이름으로 작업할 수도 있습니다.

]$ /home/opc/yugabyte-2.13.1.0/bin/yb-admin list_tablets  ysql.yb_demo_northwind categories

Tablet-UUID                             Range                                                           Leader-IP               Leader-UUID
e4216871ffd644c3b616d37668400212        partition_key_start: "" partition_key_end: "UU"                 10.0.0.61:9100          1e6aa7f085d146e8b29207483592116a
85f1061e6f10410888cbbf6418d7047c        partition_key_start: "UU" partition_key_end: "\252\252"         10.0.0.63:9100          9eec605aede445e98ad61bf833dbf6cc
2884fe988f304591b2905e5272a571f9        partition_key_start: "\252\252" partition_key_end: ""           10.0.0.62:9100          4729e36c42934175817c580b52ea6a18

그러나 이것은 이 이름을 가진 테이블이 하나만 있는 경우에만 작동합니다. 다른 스키마에서 다른 스키마를 생성하는 경우:

yb_demo_northwind=# create schema franck;
CREATE SCHEMA
yb_demo_northwind=# create table franck.categories (a int);
CREATE TABLE
yb_demo_northwind=#

동일한yb-admin 명령이 이제 이름으로 DocDB 테이블을 식별하지 못합니다.

$ /home/opc/yugabyte-2.13.1.0/bin/yb-admin -init_master_addrs=10.0.0.61:7100 list_tablets  ysql.yb_demo_northwind categories

Error running list_tablets: Invalid argument (yb/tools/yb-admin_client.cc:406): Namespace 'ysql.yb_demo_northwind' has multiple tables named 'categories', specify table id instead

요컨대

키스페이스와 테이블 이름의 조합은 YCQL에 대해서만 테이블을 식별할 수 있습니다. YSQL을 사용하면 PostgreSQL 스키마인 테이블 내에 여러 네임스페이스가 있습니다. DocDB에서 YSQL 관계를 식별하려면 PostgreSQL 객체 식별자(OID)에서 구성된 UUID인 테이블 ID를 사용해야 합니다. 위의 쿼리를 이 용도로 사용할 수 있습니다.

주말에 14살짜리 아이와 수학을 좀 했고, YSQL 테이블을 DocDB 테이블에 이름으로 매핑하는 함수가 non-injective 이라는 것을 이제 알 수 있습니다. 단사 함수를 얻으려면 UUID로 매핑해야 합니다. YCQL에 대한 테이블도 보유하고 있기 때문에 DocDB의 모든 UUID를 고려한다면 여전히 non-surjective입니다. 그러나 UUID 버전 3에서는 bijection 이므로 URL 및 yb-admin 에서 사용할 수 있습니다. YCQL 또는 시스템 테이블과 같은 다른 테이블은 UUID 버전 4입니다. 이것은 테이블 ID의 16진수 표현에서 13번째 숫자와 쉽게 구별할 수 있습니다.