Tablestore:Conectar ao DataV-Board 6.0

Pré-requisitos

• Conclua as seguintes operações no console do Resource Access Management (RAM):

  • Crie um usuário RAM e conceda a ele permissões para gerenciar o Tablestore (AliyunOTSFullAccess) e o DataV (AliyunDataVFullAccess). Para mais informações, consulte Criar um usuário RAM e Conceder permissões a um usuário RAM.

    Aviso

    O vazamento do par de AccessKey da sua conta Alibaba Cloud pode comprometer todos os seus recursos. Para reduzir esse risco, utilize o par de AccessKey de um usuário RAM nas operações.

  • Crie um par de AccessKey para o usuário RAM. Para mais informações, consulte Criar um par de AccessKey.

• Execute as operações abaixo no console do Tablestore:

  • Ative o Tablestore e crie uma instância. Para mais detalhes, consulte Ativar o Tablestore e criar uma instância.

  • Crie uma tabela de dados. Para mais informações, consulte Operações de tabela de dados.

• Realize a seguinte etapa no console do DataV:

  Ative o DataV. Para mais informações, consulte Ativar o DataV.

Contexto

O DataV é uma ferramenta de visualização de dados que transforma dados brutos em gráficos dinâmicos e interativos. Para mais informações, consulte O que é o DataV? Ao conectar seus dados do Tablestore ao DataV, crie um painel para exibir essas informações em tempo real.

Observações

• Este recurso aplica-se exclusivamente ao modelo de coluna larga. Para mais detalhes, consulte Modelo de coluna larga.

• O DataV suporta apenas tabelas de dados e tabelas de índice secundário do Tablestore como fontes de dados.

Etapa 1: Adicionar uma source de dados do Tablestore

1. Faça login no console do DataV.

2. Na aba Data Sources, selecione Data Sources e clique em Add Source.

3. Na lista Type, selecione TableStore.

   Insira o Name, AccessKey ID, AccessKey Secret e Public endpoint, depois clique em OK.

4. Configure os parâmetros da source de dados do Tablestore. Consulte a tabela a seguir para mais detalhes.

   Parâmetro	Descrição
   Name	Nome de exibição da source de dados.
   AccessKey ID	AccessKey ID da conta Alibaba Cloud ou do usuário RAM com permissão de acesso ao Tablestore.
   AccessKey Secret	AccessKey Secret da conta Alibaba Cloud ou do usuário RAM com permissão de acesso ao Tablestore.
   Public endpoint	Endpoint da instância do Tablestore que você deseja acessar. Para mais informações, consulte Endpoints.

5. Clique em OK.

   O DataV adiciona automaticamente a source à sua lista de dados.

Etapa 2: Configure a source de dados do Tablestore

1. Acesse o console do DataV.

2. Na página Projects, crie um projeto de visualização ou selecione um existente.

   • Para usar um projeto de visualização existente, localize-o e clique em Edit em seu cartão para abrir o editor.

   • Caso seja sua primeira vez no DataV ou os projetos atuais não atendam às suas necessidades, crie um novo projeto.

     Nota

     Este tópico utiliza um projeto para PC como exemplo.

     1. Clique em PC.

     2. Na lista de modelos para PC, escolha um modelo e clique em Create Project.

        O DataV permite criar uma aplicação de visualização a partir de um modelo ou de uma tela em branco.

     3. Na caixa de diálogo Create Project, insira um nome, selecione um grupo para o projeto de visualização e clique em Create.

3. Configure a source de dados do Tablestore.

   1. Na página do editor de tela, clique em um widget na tela.

      Nota

      Se não houver widgets na tela, adicione um primeiro. Para mais informações, consulte Gerenciamento de ativos (Enterprise Edition).

   2. No painel de configuração do widget à direita, clique no ícone de Dados .

   3. Na aba Data, clique em Configure Data Source.

   4. Na seção Set Data Source, defina Data Source Type como TableStore.

   5. Na lista Select an Existing Data Source, escolha sua source de dados do Tablestore.

   6. Na lista Select Action, selecione uma operação.

      As seguintes operações são suportadas:

      • getRow: corresponde à API GetRow do Tablestore. Para mais informações, consulte Referência da API GetRow.

      • getRange: equivale à API GetRange do Tablestore. Para mais detalhes, consulte Referência da API GetRange.

      • SQL: operação de consulta SQL.

   7. No editor Select Action, insira uma consulta.

      getRow

      • Os parâmetros de consulta devem ser um objeto JSON.

      • A operação getRow lê uma única linha de dados com base em sua chave primária.

        O código de exemplo a seguir mostra o formato dos parâmetros.

        {
            "table_name": "test",
            "rows": {
                "id": 1,
                "pk": "1",
            },
            "columns": [
                "id",
                "pk",
                "test"
            ]
        }

        Parâmetro	Descrição
        table_name	Nome da tabela a ser consultada.
        rows	Chave primária da linha. Importante Se a tabela possuir múltiplas colunas de chave primária, a quantidade e os tipos de dados das colunas especificadas devem corresponder aos da tabela de dados.
        columns	Nomes das colunas a serem retornadas.

      getRange

      • Os parâmetros de consulta devem ser um objeto JSON.

      • A operação getRange lê dados dentro de um intervalo de chave primária especificado. O exemplo de código abaixo ilustra o formato dos parâmetros.

        {
            "table_name": "test",
            "direction": "FORWARD",
            "columns": [
                "id",
                "test"
            ],
            "range": {
                "limit": 4,
                "start": {
                    "id": "InfMin"
                },
                "end": {
                    "id": "3"
                }
            }
        }

        Parâmetro	Descrição
        table_name	Nome da tabela alvo da consulta.
        direction	Direção de leitura das linhas. FORWARD: A chave inicial deve ser menor que a chave final. As linhas retornadas seguem ordem ascendente da chave primária. BACKWARD: A chave inicial deve ser maior que a chave final. As linhas retornadas seguem ordem descendente da chave primária. Por exemplo, suponha que uma tabela contenha dois valores de chave primária, A e B, onde A é menor que B. Na leitura ascendente de [A, B), são retornadas linhas com chave primária maior ou igual a A e menor que B. Na leitura descendente de [B, A), o retorno inclui linhas com chave primária maior que A e menor ou igual a B.
        columns	Colunas a serem lidas. Os nomes podem referir-se a colunas de chave primária ou de atributo. Caso nenhuma coluna seja especificada, o Tablestore retorna a linha inteira. Se a chave primária de uma linha estiver no intervalo de leitura, mas a linha não contiver as colunas especificadas, o resultado não incluirá essa linha.
        limit	Número máximo de linhas a retornar. Este valor deve ser maior que 0. O Tablestore interrompe a operação após retornar o número máximo de linhas definido, mesmo que existam mais dados no intervalo.
        start	Chaves primárias inicial e final para a leitura de intervalo. Devem ser chaves primárias válidas ou pontos virtuais compostos por InfMin e InfMax. A quantidade de colunas nos pontos virtuais deve coincidir com o número de colunas de chave primária. InfMin representa infinito negativo e é menor que qualquer outro valor. InfMax representa infinito positivo e é maior que qualquer outro valor. Importante Quando a tabela possui várias colunas de chave primária, a quantidade e os tipos de dados informados devem corresponder exatamente aos da tabela de dados. start: Chave primária inicial. Se esta linha existir, ela será incluída no resultado. end: Chave primária final. O resultado nunca inclui esta linha, independentemente de sua existência.
        end

      SQL

      Consulte dados utilizando instruções SQL personalizadas.

   8. Clique em Preview Data Response para visualizar os dados retornados.

4. Visualize e publique o painel.

   1. No canto superior direito do editor de tela, clique no ícone para visualizar a aplicação.

   2. No canto superior direito do editor de tela, clique no ícone para publicar o painel.

      1. Na caixa de diálogo Publish, clique em Publish Project.

      2. Feche a caixa de diálogo Published.

         Nota

         Após a publicação, o conteúdo fica bloqueado. Utilize o gerenciamento de snapshots para atualizar rapidamente o conteúdo publicado com suas edições mais recentes. Também é possível clicar em Manage Snapshots para ver os snapshots criados.

      3. Clique no ícone de cópia ao lado da Sharing URL.

         Esta opção encontra-se na aba Sharing URL do painel Publish. O formato do link é https://datav.aliyuncs.com/share/xxx.

      4. Abra um navegador e cole o link copiado na barra de endereços para visualizar o painel publicado online.

Faturamento

Perguntas frequentes

Por que a operação GetRange retorna dados fora do intervalo especificado?

Documentos relacionados

Também é possível utilizar o Grafana para visualizar dados. Conecte-se ao Grafana caso precise exibir dados de uma tabela de séries temporais em um modelo TimeSeries. Para mais informações, consulte Conectar ao Grafana.