Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Crie um tipo definido pelo usuário (UDT) no Amazon Keyspaces

Modo de foco
Crie um tipo definido pelo usuário (UDT) no Amazon Keyspaces - Amazon Keyspaces (para Apache Cassandra)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Para criar um UDT em um espaço de chave de região única, você pode usar a CREATE TYPE instrução emCQL, o create-type comando com o AWS CLI ou o console.

UDTos nomes devem conter 48 caracteres ou menos, devem começar com um caractere alfabético e só podem conter caracteres alfanuméricos e sublinhados. O Amazon Keyspaces converte automaticamente caracteres maiúsculos em caracteres minúsculos.

Como alternativa, você pode declarar um UDT nome entre aspas duplas. Ao declarar um UDT nome entre aspas duplas, o Amazon Keyspaces preserva maiúsculas e permite caracteres especiais.

Você também pode usar aspas duplas como parte do nome ao criar oUDT, mas deve escapar de cada caractere de aspas duplas com um caractere adicional de aspas duplas.

A tabela a seguir mostra exemplos de UDT nomes permitidos. A primeira coluna mostra como inserir o nome ao criar o tipo, a segunda coluna mostra como o Amazon Keyspaces formata o nome internamente. O Amazon Keyspaces espera o nome formatado para operações como. GetType

Nome inserido Nome formatado Observação
MY_UDT my_udt Sem aspas duplas, o Amazon Keyspaces converte todos os caracteres maiúsculos em minúsculas.
"MY_UDT" MY_UDT Com aspas duplas, o Amazon Keyspaces respeita os caracteres maiúsculos e remove as aspas duplas do nome formatado.
"1234" 1234 Com aspas duplas, o nome pode começar com um número, e o Amazon Keyspaces remove as aspas duplas do nome formatado.
"Special_Ch@r@cters<>!!" Special_Ch@r@cters<>!! Com aspas duplas, o nome pode conter caracteres especiais, e o Amazon Keyspaces remove as aspas duplas do nome formatado.
"nested""""""quotes" nested"""quotes O Amazon Keyspaces remove as aspas duplas externas e as aspas duplas de escape do nome formatado.
Console
Crie um tipo definido pelo usuário (UDT) com o console do Amazon Keyspaces
  1. Faça login no AWS Management Console e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.

  2. No painel de navegação, escolha Keyspaces e, em seguida, escolha um keyspace na lista.

  3. Escolha a guia UDTs.

  4. Escolha Criar UDT

  5. Em UDTdetalhes, insira o nome doUDT. Em UDTcampos, você define o esquema doUDT.

  6. Para finalizar, escolha Criar UDT.

Cassandra Query Language (CQL)
Crie um tipo definido pelo usuário (UDT) com CQL

Neste exemplo, criamos uma nova versão da tabela de prêmios de livros usada emCrie uma tabela no Amazon Keyspaces.. Nesta tabela, armazenamos todos os prêmios que um autor recebe por um determinado livro. Criamos dois UDTs que estão aninhados e contêm informações sobre o livro que recebeu um prêmio.

  1. Crie um keyspace com o nomecatalog. Observe que não UDTs são compatíveis com espaços de chave multirregionais.

    CREATE KEYSPACE catalog WITH REPLICATION = {'class': 'SingleRegionStrategy'};
  2. Crie o primeiro tipo. Esse tipo armazena BISACcódigos, que são usados para definir o gênero dos livros. Um BISAC código consiste em um código alfanumérico e em até quatro áreas temáticas.

    CREATE TYPE catalog.bisac ( bisac_code text, subject1 text, subject2 text, subject3 text, subject4 text );
  3. Crie um segundo tipo para prêmios de livros que use o primeiroUDT. O ninho UDT deve ser congelado.

    CREATE TYPE catalog.book ( award_title text, book_title text, publication_date date, page_count int, ISBN text, genre FROZEN <bisac> );
  4. Crie uma tabela com uma coluna para o nome do autor e use um tipo de lista para os prêmios do livro. Observe que o UDT usado na lista deve ser congelado.

    CREATE TABLE catalog.authors ( author_name text PRIMARY KEY, awards list <FROZEN <book>> );
  5. Nesta etapa, inserimos uma linha de dados na nova tabela.

    CONSISTENCY LOCAL_QUORUM;
    INSERT INTO catalog.authors (author_name, awards) VALUES ( 'John Stiles' , [{ award_title: 'Wolf', book_title: 'Yesterday', publication_date: '2020-10-10', page_count: 345, ISBN: '026204630X', genre: { bisac_code:'FIC014090', subject1: 'FICTION', subject2: 'Historical', subject3: '20th Century', subject4: 'Post-World War II'} }, {award_title: 'Richard Roe', book_title: 'Who ate the cake?', publication_date: '2019-05-13', page_count: 193, ISBN: '9780262046305', genre: { bisac_code:'FIC022130', subject1: 'FICTION', subject2: 'Mystery & Detective', subject3: 'Cozy', subject4: 'Culinary'} }] );
  6. Na última etapa, lemos os dados da tabela.

    SELECT * FROM catalog.authors;

    A saída do comando deve ser semelhante a esta.

    author_name | awards -------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- John Stiles | [{award_title: 'Wolf', book_title: 'Yesterday', publication_date: 2020-10-10, page_count: 345, isbn: '026204630X', genre: {bisac_code: 'FIC014090', subject1: 'FICTION', subject2: 'Historical', subject3: '20th Century', subject4: 'Post-World War II'}}, {award_title: 'Richard Roe', book_title: 'Who ate the cake?', publication_date: 2019-05-13, page_count: 193, isbn: '9780262046305', genre: {bisac_code: 'FIC022130', subject1: 'FICTION', subject2: 'Mystery & Detective', subject3: 'Cozy', subject4: 'Culinary'}}] (1 rows)

    Para mais informações sobre sintaxe de CQL, consulte CREATE TYPE.

CLI
Crie um tipo definido pelo usuário (UDT) com o AWS CLI
  1. Para criar um tipo, você pode usar a seguinte sintaxe.

    aws keyspaces create-type --keyspace-name 'my_keyspace' --type-name 'my_udt' --field-definitions '[ {"name" : "field1", "type" : "int"}, {"name" : "field2", "type" : "text"} ]'
  2. A saída desse comando é semelhante a este exemplo. Observe que typeName retorna o nome formatado doUDT.

    { "keyspaceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/", "typeName": "my_udt" }
Crie um tipo definido pelo usuário (UDT) com o console do Amazon Keyspaces
  1. Faça login no AWS Management Console e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.

  2. No painel de navegação, escolha Keyspaces e, em seguida, escolha um keyspace na lista.

  3. Escolha a guia UDTs.

  4. Escolha Criar UDT

  5. Em UDTdetalhes, insira o nome doUDT. Em UDTcampos, você define o esquema doUDT.

  6. Para finalizar, escolha Criar UDT.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.