User Defined Types
31 August 2017
CQL은 사용자 정의 유형 (UDT)의 정의를 지원합니다.
이러한 유형은 아래에 설명 된 create_type_statement, alter_type_statement 및 drop_type_statement를 사용하여 작성, 수정 및 제거 할 수 있습니다.
그러나 일단 만들어지면, UDT는 단순히 그 이름으로 참조됩니다 :
user_defined_type ::= udt_name
udt_name ::= [ keyspace_name '.' ] identifier
Creating a UDT
새 사용자 정의 유형 작성은 다음에 의해 정의 된 CREATE TYPE 문을 사용하여 수행됩니다.
create_type_statement ::= CREATE TYPE [ IF NOT EXISTS ] udt_name
'(' field_definition ( ',' field_definition )* ')'
field_definition ::= identifier cql_type
필드 이름은 콜렉션 또는 다른 UDT를 포함하여 모든 유형이 될 수 있습니다.
예를 들어 :
CREATE TYPE phone (
country_code int,
number text,
)
CREATE TYPE address (
street text,
city text,
zip text,
phones map
)
CREATE TABLE user (
name text PRIMARY KEY,
addresses map
>
)
- IF NOT EXISTS 옵션을 사용하지 않으면 이미 존재하는 유형을 생성하려고하면 오류가 발생합니다.
사용되는 경우 유형이 이미 존재하면 아무런 동작을 하지 않습니다.
- 유형은 본질적으로 생성 된 키 스페이스에 바인드되며 해당 키 스페이스에서만 사용할 수 있습니다.
생성시, 유형 이름 앞에 키 스페이스 이름이 있으면 해당 키 스페이스에 유형 이름이 작성됩니다.
그렇지 않으면, 현재 키 스페이스에 작성됩니다.
- Cassandra 4.0에서 UDT는 대부분의 경우 동결되어야하므로 위의 테이블 정의에서
frozen 를 사용해야합니다.
자세한 내용은 고정 섹션을 참조하십시오.
UDT literals
일단 사용자 정의 된 타입이 생성되면, 값은 UDT 리터럴을 사용하여 입력 될 수 있습니다 :
udt_literal ::= '{' identifier ':' term ( ',' identifier ':' term )* '}'
예를 들어, 다음을 사용하여 이전 섹션에서 정의한 테이블에 삽입 할 수 있습니다.
INSERT INTO user (name, addresses)
VALUES ('z3 Pr3z1den7', {
'home' : {
street: '1600 Pennsylvania Ave NW',
city: 'Washington',
zip: '20500',
phones: { 'cell' : { country_code: 1, number: '202 456-1111' },
'landline' : { country_code: 1, number: '...' } }
},
'work' : {
street: '1600 Pennsylvania Ave NW',
city: 'Washington',
zip: '20500',
phones: { 'fax' : { country_code: 1, number: '...' } }
}
})
Altering a UDT
기존 사용자 정의 유형은 ALTER TYPE 문을 사용하여 수정할 수 있습니다 :alter_type_statement ::= ALTER TYPE udt_name alter_type_modification
alter_type_modification ::= ADD field_definition
| RENAME identifier TO identifier ( identifier TO identifier )*
- 유형에 새 필드를 추가합니다 (ALTER TYPE address ADD country text).
그 새로운 필드는 추가 전에 작성된 모든 값에 대해 null이됩니다.
- 유형의 필드 이름을 바꿉니다 (ALTER TYPE address RENAME zip TO zipcode).
Dropping a UDT
DROP TYPE 문을 사용하여 기존 사용자 정의 유형을 삭제할 수 있습니다.
drop_type_statement ::= DROP TYPE [ IF EXISTS ] udt_name
그러나 다른 유형, 테이블 또는 함수에서 계속 사용중인 유형을 삭제하려고 시도하면 오류가 발생합니다.
삭제 된 유형이 없는 경우 IF EXISTS가 사용되지 않으면 오류가 반환됩니다.
사용되는 경우 작업은 아무 작업도 수행하지 않습니다.
출처 : http://cassandra.apache.org/doc/latest/cql/types.html