Central de documentação

Todos os produtos

Central de documentação

DataHub:Termos

Última atualização: Jun 28, 2026

Termos

Termo	Descrição
Project	O projeto é a unidade organizacional básica de dados no DataHub e contém vários tópicos. Os projetos do DataHub são independentes dos projetos do MaxCompute.
Topic	O tópico é a unidade mínima para assinatura e publicação de dados no DataHub. Use um tópico para representar uma classe ou tipo de dados em streaming.
Período de tempo de vida (TTL) de um tópico	O período de tempo de vida (TTL) de um tópico define o tempo máximo de retenção dos dados gravados nele. A unidade é dia, com valores de 1 a 7.
Shard	Um shard é um canal concorrente para transmissão de dados em um tópico. Cada shard possui um ID exclusivo. Shards ativos consomem recursos do servidor. Crie shards conforme a necessidade. Para mais informações sobre os diferentes estados de um shard, consulte Estados do shard.
Intervalo de chave de hash do shard	Propriedade de um shard que especifica o intervalo de valores da chave de hash. O intervalo é fechado à esquerda e aberto à direita. Dados com a mesma chave são gravados no mesmo shard.
Mesclagem de shards	A mesclagem de shards combina shards com intervalos de chave contíguos em um único shard. Para mais detalhes, consulte Operações de shard.
Divisão de shard	A divisão de shard separa um shard em dois novos shards com intervalos de chave contíguos.
Record	Unidade básica de interação entre os dados do usuário e o DataHub.
Tipo de registro	Tipo de dados de um tópico. O DataHub oferece suporte aos tipos Tuple e BLOB. Tópicos do tipo Tuple aceitam registros de dados semelhantes aos de bancos de dados. Cada registro contém várias colunas. Tópicos do tipo BLOB permitem apenas a gravação de um bloco de dados binários. Para mais informações sobre os tipos de dados compatíveis, consulte Tipos de dados.

Tipos de dados

Tipo Tuple: Permite gravar dados dos seguintes tipos:

O DataHub oferece suporte aos tipos de dados TINYINT, SMALLINT, INTEGER e FLOAT a partir do Java SDK V2.16.1-public.

Tipo	Descrição	Intervalo
BIGINT	Inteiro assinado de 8 bytes	`-9223372036854775807 to 9223372036854775807`
DOUBLE	Número de ponto flutuante de precisão dupla de 8 bytes	`-1,0 × 10^308 to 1,0 × 10^308`
BOOLEAN	Tipo booleano	True/true/1 False/false/0
TIMESTAMP	Tipo timestamp	Timestamp com precisão de microssegundos.
STRING	String. Compatível apenas com codificação UTF-8.	Uma única coluna STRING pode ter até 2 MB.
TINYINT	Inteiro de byte único	`-128 to 127`
SMALLINT	Inteiro de dois bytes	`-32768 ~ 32767`
INTEGER	Inteiro de 4 bytes	`-2147483648 to 2147483647`
FLOAT	Número de ponto flutuante de precisão simples de 4 bytes	`-3,40292347 × 10^38 to 3,40292347 × 10^38`
DECIMAL	Tipo numérico	`-10^38 + 1 to 10^38 - 1`

No modo Blob, você pode gravar um bloco de dados binários como um registro. A transmissão desses dados usa codificação Base64.

Estados do shard

Estado	Descrição	Suporte a leitura/gravação
Opening	Ao criar um tópico, todos os seus shards ficam no estado Opening durante a inicialização.	Não há suporte para operações de leitura e gravação.
Active	Após a abertura do canal, o shard entra no estado Active.	Há suporte para operações normais de leitura e gravação.
Closing	O shard assume o estado Closing durante uma operação de divisão ou mesclagem.	Não há suporte para operações de leitura e gravação.
Closed	Após a conclusão da operação de divisão ou mesclagem, o shard entra no estado Closed.	Somente leitura.

Descrições de erros

ErrorCode	HttpCode	Descrição
InvalidUriSpec	400	O URI solicitado é inválido.
InvalidParameter	400	Parâmetro inválido. Para mais detalhes, consulte a mensagem de erro retornada.
Unauthorized	401	Erro de assinatura.
NoPermission	403	Permissões insuficientes na conta.
InvalidSchema	400	Formato de schema inválido.
InvalidCursor	400	O cursor é inválido ou expirou.
NoSuchProject	404	O projeto solicitado não existe.
NoSuchTopic	404	O tópico solicitado não existe.
NoSuchShard	404	O ID do shard solicitado não existe.
ProjectAlreadyExist	400	O projeto já existe.
TopicAlreadyExist	400	O tópico já existe.
InvalidShardOperation	405	Operação de shard inválida. Por exemplo, tentativa de gravar dados em um shard após seu fechamento.
LimitExceeded	400	Os parâmetros da solicitação excedem o limite permitido. Por exemplo, o número total de shards ultrapassa 512.
InternalServerError	500	Erro desconhecido, exceção interna do serviço ou atualização do sistema em andamento.