Todos os produtos
Search

Este produto

    ApsaraDB for SelectDB:Etapa 2: Conectar ao SelectDB e criar um banco de dados e uma tabela

    Central de documentação

    ApsaraDB for SelectDB:Etapa 2: Conectar ao SelectDB e criar um banco de dados e uma tabela

    Última atualização: Jun 29, 2026

    Conecte-se à sua instância do ApsaraDB for SelectDB pelo SQL Editor e crie um banco de dados e uma tabela para começar. Se utilizar outros clientes, como Data Management (DMS) ou um cliente MySQL, consulte a documentação relacionada neste tópico.

    Pré-requisitos

    Você já criou uma instância do SelectDB. Para obter instruções, consulte Etapa 1: Criar uma instância do SelectDB.

    Procedimento

    Etapa 1: Definir a senha da conta admin

    O sistema cria uma conta admin por padrão durante a criação da instância do SelectDB. Defina a senha dessa conta antes de usá-la para fazer login.

    1. Acesse a página SelectDB Instances. No canto superior esquerdo, selecione a região da sua instância. Clique em ID da instância desejada.

    2. Na página Instance Details, clique em Reset Password no canto superior direito.

    3. Na caixa de diálogo Reset Password, defina uma nova senha e clique em OK.

    Etapa 2: Conectar-se à instância

    Após definir a senha, você permanece na página Instance Details.

    1. Na página Instance Details, clique em Data Development and Management no canto superior direito.

      Nota

      Se esta for a primeira vez que você usa o Data Development and Management, uma mensagem solicitará a adição do seu endereço IP público local ao grupo de lista de permissões de IP webui_whitelist. Leia a mensagem com atenção e clique em OK.

    2. Na lista suspensa, clique em SQL Editor para abrir a página SQL Editor.

      Se a página abrir com êxito, a conexão com a instância do SelectDB estará estabelecida.

      Nota

      • Caso seja a primeira vez que você utiliza o SQL Editor e não esteja conectado ao WebUI, o sistema redirecionará você para a página de login. Faça login com a conta admin. Após o login, a página SQL Editor será exibida.

      • Se você já utilizou o SQL Editor anteriormente, clicar em SQL Editor levará diretamente à página SQL Editor.

      image

    Etapa 3: Criar um banco de dados

    Na página SQL Editor, insira e execute a seguinte instrução.

    CREATE DATABASE test_db;

    1. No editor de texto à direita, insira a instrução.

    2. Clique em Run (limit 1000).

      Uma mensagem de sucesso na área Execution Result indica que o banco de dados foi criado. Você também pode clicar em ícone de atualização no canto superior direito para visualizar o novo banco de dados.

    Etapa 4: Criar uma tabela

    Na página SQL Editor, insira e execute a seguinte instrução.

    CREATE TABLE test_tb
(
    k1 TINYINT,
    k2 DECIMAL(10, 2) DEFAULT "10.05",
    k3 CHAR(10) COMMENT "string column",
    k4 INT NOT NULL DEFAULT "1" COMMENT "int column"
)
COMMENT "my first table"
DISTRIBUTED BY HASH(k1) BUCKETS 16;

    1. Selecione o banco de dados e o cluster de destino.

      No canto superior direito da página, selecione o banco de dados alvo na segunda lista suspensa e o cluster correspondente na terceira lista suspensa.

    2. No editor de texto à direita, insira a instrução.

    3. Clique em Run (limit 1000).

      Uma mensagem de sucesso na área Execution Result confirma a criação da tabela. Você também pode clicar em ícone de atualização no canto superior direito para ver a nova tabela.

    Etapa 5 (Opcional): Importar e consultar dados

    O SelectDB oferece suporte a diversos métodos de importação de dados. Esta seção utiliza o Stream Load para importar dados CSV locais para a tabela test_tb. Para mais informações sobre o Stream Load, consulte Stream Load.

    1. Adicione um endereço IP à lista de permissões.

      No painel de navegação à esquerda da página Instance Details, clique em Data Security. Na página Data Security, clique em Create Whitelist e adicione o endereço IP público do seu ambiente local à lista de permissões de endereços IP da instância.

    2. Prepare os dados de source.

      No seu ambiente local, prepare um arquivo de dados no formato CSV. Para ver um exemplo, consulte test_tb.csv.

    3. Importe os dados.SintaxeParâmetrosExemplo

      Abra um terminal no seu ambiente local e execute um comando curl para iniciar um trabalho do Stream Load.

      curl --location-trusted -u <username>:<password> -H "expect:100-continue" -H "column_separator:," -T <file_path> -XPUT http://<host>:<port>/api/<db_name>/<table_name>/_stream_load

      Parâmetro

      Descrição

      --location-trusted

      Transmite o username e a password para o host de redirecionamento caso a autenticação seja necessária.

      -u

      Nome de usuário e senha da sua instância do ApsaraDB for SelectDB.

      -H

      Cabeçalho de requisição para o trabalho do Stream Load. Parâmetros comuns:

      • label: Identificador exclusivo para o trabalho de importação.

      • column_separator: Delimitador de colunas no arquivo de source. O padrão é \t. Também é possível usar uma string de vários caracteres como delimitador. Para caracteres não imprimíveis, use \x como prefixo seguido pelo valor hexadecimal do caractere.

      -T

      Caminho local do arquivo de dados a ser importado.

      -XPUT

      Método HTTP PUT. A URL da requisição especifica o destino da importação com os seguintes componentes:ApsaraDB for SelectDB

      • host: Endpoint da VPC ou endpoint público da instância do ApsaraDB for SelectDB.

        Nota

        Se o cliente que executa o comando não estiver na mesma VPC da sua instância do SelectDB, será necessário usar o endpoint público. Para solicitar um endpoint público, consulte Solicitar e liberar um endpoint público.

        Caso seu cliente seja um serviço da Alibaba Cloud na mesma VPC da instância do SelectDB, recomendamos o uso do endpoint da VPC.

      • port: Porta HTTP da instância do ApsaraDB for SelectDB. O padrão é 8080.

        Nota

        É possível encontrar o endpoint e a porta da sua instância do ApsaraDB for SelectDB na respectiva página do ApsaraDB for SelectDB.

      • db_name: Nome do banco de dados.

      • table_name: Nome da tabela.

      		 
      curl --location-trusted -u admin:07b1**** -T C:\Users\****\Downloads\test_tb.csv -H "label:test123" -H "expect:100-continue" -H "column_separator:," selectdb-cn-vc****-public.selectdbfe.rds.aliyuncs.com:8080/api/test_db/test_tb/_stream_load

    4. Visualize os resultados da importação.

      Na página SQL Editor, insira e execute a seguinte instrução:

      SELECT * FROM test_tb;

      Clique em Run (limit 1000). Os dados de amostra importados serão exibidos na área Execution Result, no canto inferior direito da página.

    Próximas etapas

    Neste ponto, você se conectou a uma instância do SelectDB, criou um banco de dados e uma tabela, além de importar dados via Stream Load. Para projetar tabelas adequadas às necessidades do seu negócio, recomendamos fortemente que estude os princípios fundamentais de design de bancos de dados e tabelas do SelectDB. Propriedades de tabela bem definidas ajudam a evitar impactos negativos nas suas operações.

    Etapa 3: Aprender os princípios fundamentais de design de bancos de dados e tabelas

    Documentos relacionados

    APIs relacionadas