Todos os produtos
Search
Central de documentação

ApsaraDB for OceanBase (Deprecated):Criar um tenant

Última atualização: Aug 20, 2026

Este tópico descreve como criar e gerenciar tenants no console do OceanBase.

Conceitos

  • Tenant: Um tenant é um subconjunto dos recursos de um cluster do OceanBase. Trata-se de um conceito lógico, semelhante a uma instância no MySQL ou Oracle. O tenant serve como base para gerenciar objetos e recursos de banco de dados, funcionando como contêiner para diversos elementos, como CPU, memória e I/O. O OceanBase Database utiliza tenants para garantir o isolamento de recursos e adota um modelo de gerenciamento multi-tenant em cluster único, no qual recursos e dados ficam isolados entre os tenants. Cada tenant possui seu próprio conjunto de recursos de computação e armazenamento, oferecendo um service de banco de dados completo e independente. Para mais informações, consulte Multi-tenant architecture.

  • Unidade de recurso (Unit): Uma unidade de recurso define os recursos disponíveis, como memória, CPU e I/O, para um tenant em um nó específico. Ela também atua como unidade básica para o balanceamento de carga do cluster. Quando nós entram ou saem de operação, ou quando o cluster passa por scale-out ou scale-in, o sistema ajusta dinamicamente a distribuição das unidades de recurso nos nós para equilibrar o uso dos recursos. Para mais informações, consulte Manage resources.

Pré-requisitos

Você já criou uma instância de cluster. Para mais informações, consulte Purchase an instance.

Limites

O número máximo de tenants que podem ser criados em uma única instância de cluster segue a seguinte regra de cálculo:

Número máximo de tenants = min(Número de núcleos de CPU em um único nó do cluster × Número de nós do cluster, Número máximo de tenants permitidos no cluster). O limite máximo de tenants por cluster é 50.

Nota

Em um cenário 2F, uma instância de cluster suporta no máximo 32 tenants. Já em um cenário 3F, o suporte chega a até 50 tenants.

Procedimento

  1. Faça login no OceanBase console.

  2. No painel de navegação à esquerda, clique em Instance List.

  3. Na lista de instâncias, localize a instância de cluster desejada e clique em seu nome para acessar o Cluster Instance Workspace.

  4. No canto superior direito da página, clique em Create Tenant.

    image

  5. Configure os parâmetros do tenant.

    Parâmetros de configuração

    Descrição

    Tenant Name

    Especifique um nome para o tenant.

    O nome deve ter entre 2 e 64 caracteres, podendo conter caracteres chineses, dígitos, letras, sublinhados (_) e hifens (-). Há distinção entre maiúsculas e minúsculas, e o nome deve começar com uma letra ou sublinhado. Não é permitido usar o valor sys.

    Tenant Mode

    Defina o modo como Oracle ou MySQL.

    Nota

    Para instâncias de cluster Standard Edition (Key-Value), só é possível criar tenants no modo MySQL.

    Parameter Template

    Quatro modelos de parâmetros estão disponíveis. Para detalhes sobre os parâmetros e variáveis específicos, consulte Parameter template descriptions.

    Nota

    A configuração de modelo de parâmetros é suportada apenas para novas instalações do OceanBase V4.3.3 ou versões posteriores.

    • OLTP Simple Transaction: Ideal para sistemas centrais, como plataformas de pedidos online e pagamentos, além de services de internet com consultas pontuais de alta concorrência. As instruções SQL executadas são simples e exigem respostas rápidas. OLTP significa processamento transacional online.

    • OLTP Complex Transaction: Recomendado para sistemas de negociação online com transações complexas. Abrange cenários com junções elaboradas, subconsultas e jobs em lote escritos em PL, onde podem ocorrer transações longas e volumosas. Se esta instância de cluster for dedicada a cargas de trabalho OLTP, otimize o parâmetro de política de consultas grandes large_query_threshold no cluster, alterando o valor padrão de 600s para 5s.

    • HTAP Mixed Workload: Projetado para cargas mistas que combinam transações e análises online. Este modelo oferece capacidades OLTP e utiliza vetorização para melhorar o desempenho computacional em cenários de análise online. HTAP refere-se ao processamento híbrido transacional e analítico.

    • OLAP Online Analytics: Mais indicado para cenários de data warehouse em tempo real envolvendo processamento analítico online (OLAP). Por padrão, as tabelas são criadas em formato de armazenamento colunar, utilizando um mecanismo vetorizado otimizado para elevar o desempenho em análises complexas. Caso o cluster seja focado exclusivamente em OLAP, ajuste as variáveis de sistema e os parâmetros do cluster: ative a computação paralela adaptativa, otimize o espaço de memória para ordenação SQL, configure timeouts para SQL e transações, além da política de consultas grandes. Defina também o conjunto de caracteres do tenant como utf8mb4_bin.

    Character Set

    Selecione um conjunto de caracteres para o banco de dados.

    • Tenants no modo MySQL suportam os seguintes conjuntos de caracteres:

      • utf8mb4_general_ci

      • utf8mb4_bin

      • utf8mb4_unicode_ci

      • utf16_general_ci

      • utf16_bin

      • utf16_unicode_ci

      • gbk_chinese_ci

      • gbk_bin

      • gb18030_chinese_ci

      • gb18030_bin

      • binary

    • Tenants no modo Oracle suportam os seguintes conjuntos de caracteres:

      • utf8

      • gbk

    Nota

    Para instâncias de cluster Standard Edition (Key-Value), novos tenants aceitam apenas o conjunto de caracteres utf8mb4. Essa configuração não pode ser alterada posteriormente.

    Table Name Case Sensitivity

    Especifique se os nomes das tabelas devem diferenciar maiúsculas de minúsculas.

    Nota
    • Este parâmetro é obrigatório quando o Tenant Mode estiver definido como MySQL. Por padrão, não há distinção entre maiúsculas e minúsculas nos nomes das tabelas.

    • Não é possível alterar essa configuração após a criação do tenant.

    Time Zone

    Especifique as informações de fuso horário.

    Number of Resource Units

    Defina a quantidade de unidades de recurso para o tenant.

    Para aumentar o número de unidades, primeiro escale horizontalmente os nós do cluster. Para mais informações, consulte Add or remove nodes.

    Allocated Resources

    Especifique a quantidade de CPU e memória destinada ao tenant em um único nó. Clique em More Advanced Configurations para configurar as operações de entrada/saída por segundo (IOPS) disponíveis e o tamanho do disco de log do tenant.

    Nota
    • Apenas tenants do OceanBase Database V4.x permitem definir o tamanho do disco de log.

    • A configuração de IOPS disponíveis é suportada somente em tenants do OceanBase Database V4.2.5 ou superior.

    • Instâncias de cluster do OceanBase Database V3.x e V4.x permitem criar tenants com 1 núcleo e 4 GB de memória.

    • A soma total de CPU e memória de todos os tenants não pode ultrapassar as especificações da instância de cluster. Nas versões V4.x, o tamanho total do disco de log de todos os tenants também não pode exceder a capacidade de disco de log do cluster.

    • Total de recursos disponíveis para um tenant = Recursos alocados em um único nó × Número de nós para distribuição de recursos × Número de réplicas

    VPC Network for Primary Endpoint

    Selecione o ID da virtual private cloud (VPC) onde reside a instância do banco de dados. Utilize a VPC na qual sua aplicação ou negócio está implantado para reduzir a latência de acesso.

    Caso não haja uma VPC adequada, siga as instruções na tela para criar uma. Para mais informações, consulte What is a virtual private cloud (VPC)?.

    Primary Zone for Tenant

    Escolha a zona primária do tenant. É possível selecionar múltiplas zonas primárias.

    Primary Zone for Primary Endpoint

    Selecione a zona onde o agente do endpoint primário será implantado.

    Nota

    Se a zona do agente do endpoint primário for diferente da zona de dados primária, poderá haver risco de latência de dados.

    VSwitch for Primary Endpoint

    Selecione o ID do vSwitch ao qual o endpoint primário estará vinculado. Verifique a quantidade de endereços IP privados disponíveis; se esse número for 0, será necessário escolher uma nova VPC e um novo vSwitch.

    Se não houver um vSwitch adequado, siga as orientações na tela para criar um. Para mais informações, consulte Create and manage vSwitches.

    Tenant Whitelist

    Os grupos de lista de permissões da instância de cluster são sincronizados automaticamente com o tenant. Alterações na lista de permissões da instância de cluster afetam todos os tenants desse cluster. Posteriormente, você pode adicionar outros grupos de lista de permissões específicos para o tenant. Para mais informações, consulte Configure a whitelist group for a tenant.

    Remarks (Optional)

    As observações não podem ultrapassar 30 caracteres.

  6. Clique em Create. Acompanhe o progresso da criação do tenant na página Instance List.