Ir para o conteúdo

Usa TablePro todo dia? Uma licença adiciona recursos pagos e financia a próxima versão. Compre uma licençaCompre uma licença

Cliente de Cassandra e ScyllaDB para Mac

Explore keyspaces e tabelas, execute CQL no editor e edite linhas gravadas pela chave primária completa. O mesmo driver se conecta a ScyllaDB e Amazon Keyspaces.

Funciona em MacO driver é baixado na primeira vez que você escolhe Cassandra

Uma tabela Cassandra aberta da barra lateral na grade de dados, com um valor de status alterado marcado como pendente até ser salvo e uma coluna set mostrada como coleção.

Visão geral

Linguagem de consulta
CQL
Driver
Baixado no primeiro usoCompartilhado com ScyllaDB
Conectar por
Host e porta, Túnel SSH, SSL/TLS, AWS IAM
Porta padrão
9042
Versão mínima
3.0, documentada
iPhone e iPad
Não abre

Conecte-se

Informe um ponto de contato e sua porta ao TablePro, além de usuário e senha quando o cluster tem um autenticador configurado. Não há campo keyspace: escolha um na barra lateral após conectar, ou coloque-o no caminho de uma URL cassandra:// ou cql:// e importe-a. Alternar keyspaces acontece na mesma conexão e exclui os keyspaces de sistema da lista, enquanto abas já abertas permanecem nos próprios keyspaces.

TLS está desativado em uma conexão nova. Preferred e Required criptografam sem verificar o certificado, pois o driver não tem TLS oportunista. Verify CA e Verify Identity exigem um arquivo de certificado CA e nunca usam as raízes do sistema como alternativa. Para TLS mútuo, adicione um certificado de cliente, sua chave e a frase secreta da chave. Um cluster em rede privada é acessado por um túnel SSH.

Amazon Keyspaces entra com SigV4 em vez de senha. Use o endpoint regional, como cassandra.us-east-1.amazonaws.com na porta 9142, defina Authentication como um modo AWS IAM (inglês) (chave de acesso, perfil ou AWS IAM Identity Center), deixe usuário e senha vazios e ative TLS, pois Keyspaces recusa texto simples.

Explore e execute CQL

Abra uma tabela pela barra lateral para lê-la na grade. Listas, conjuntos, mapas e tuplas aparecem como coleções, um tipo definido pelo usuário como seus campos, um duration como 1d2h30m, um vetor como lista de números e um blob em hexadecimal. Resultados no editor CQL são somente leitura, portanto as linhas são alteradas pela tabela aberta na barra lateral.

CQL não tem OFFSET, portanto as páginas são lidas a partir da primeira linha: Next e Previous em páginas já exibidas custam uma leitura cada, e saltar para uma página distante lê todas as anteriores. As linhas chegam na ordem dos tokens, e um cabeçalho de coluna não as reordena, pois CQL só ordena por colunas de clustering dentro de uma partição. Nada é contado ao abrir uma tabela; Count Exactly executa SELECT COUNT(*), que lê todas as partições.

Os filtros adicionam ALLOW FILTERING, portanto o servidor lê todas as partições, a menos que o filtro fixe toda a chave de partição. Contém, começa com e termina com são enviados como LIKE, que Cassandra só aceita em uma coluna com índice SASI ou SAI. Operadores que CQL não expressa, como diferente de ou is NULL, são recusados pelo nome, e condições se unem apenas com AND, pois CQL não tem OR.

Um valor editado é enviado com o tipo CQL da coluna, e um valor que não pode ser interpretado interrompe todo o salvamento. Cada linha é gravada por uma instrução própria, identificada pela chave primária completa. Add Row grava INSERT … IF NOT EXISTS, portanto uma linha nova nunca sobrescreve outra que já possui sua chave. Uma coluna de chave não pode ser alterada no local: exclua a linha e adicione-a novamente.

Colunas contador precisam de UPDATE … SET c = c + 1 no editor CQL; o servidor rejeita o UPDATE simples gerado por uma edição na grade. O timeout de conexão vem de Options da conexão, enquanto requisições CQL mantêm o timeout fixo do driver, que o timeout de consulta do app não altera.

Keyspaces e tabelas

A aba Structure lista o tipo CQL de cada coluna, marca colunas de chave de partição e clustering como chave primária e mostra os índices secundários da tabela. Ela adiciona e remove colunas; todas as outras alterações, inclusive índices, usam uma instrução CQL no editor.

A aba DDL reconstrói CREATE TABLE da lista de colunas, portanto omite opções como compactação, ordem de clustering e separação entre chaves de partição e clustering. Leia a definição completa com DESCRIBE TABLE no cqlsh. Funções e agregações definidas pelo usuário são listadas em Functions.

Mova dados

TablePro não tem importação para Cassandra ou ScyllaDB. Exporte uma tabela ou um resultado CQL como CSV, JSON, SQL, XLSX, Markdown, HTML e XML.

iPhone e iPad

O app para iPhone e iPad não tem um driver de Cassandra. As conexões Cassandra sincronizadas de um Mac aparecem na lista, mas não abrem.

Limitações

  • Apenas colunas escalares podem ser editadas na grade. Coleções, tuplas, tipos definidos pelo usuário e durações exigem UPDATE no editor.
  • Não há configuração de nível de consistência. As instruções usam o padrão do driver, LOCAL_ONE.
  • DataStax Astra DB não conecta, pois seu pacote de conexão segura não pode ser carregado.
  • Visualizações materializadas e tipos definidos pelo usuário não aparecem na barra lateral.

ScyllaDB

Porta padrão 9042Baixado no primeiro usoiPhone e iPad: Não abre

ScyllaDB tem sua própria entrada na lista de tipos de conexão e usa o driver Cassandra pelo mesmo protocolo nativo CQL, portanto conexão, navegação, edição e as limitações acima se aplicam como descrito. Uma URL scylladb:// ou scylla:// cria uma conexão ScyllaDB.

Uma diferença aparece na barra de filtros: ScyllaDB aceita o LIKE enviado por contém, começa com e termina com em qualquer coluna, enquanto Cassandra exige índice SASI ou SAI. ScyllaDB é configurado conforme o guia de configuração de Cassandra (inglês).

Guia de configuração de ScyllaDB (inglês)

Perguntas sobre Cassandra

TablePro mostra o status dos nós ou do anel?

Não. Não há Server Dashboard para Cassandra ou ScyllaDB. Verifique os nós com nodetool status e use TablePro para keyspaces, tabelas e CQL.

Como vejo views materializadas e tipos definidos pelo usuário?

Eles não aparecem na barra lateral, portanto consulte o keyspace system_schema no editor CQL, por exemplo SELECT * FROM system_schema.views ou system_schema.types.

TablePro se conecta a Cassandra 2.x?

Não. O driver lê o esquema de system_schema, que Cassandra 2.x não possui, portanto a conexão falha.

Baixe TablePro

O app para Mac é gratuito para baixar e usar. Um plano Starter ou Team adiciona recursos opcionais.
Baixar para Mac

Requer macOS 13 Ventura ou posterior