Todos os produtos
Search

Este produto

    Object Storage Service:Definir configuração de manutenção da tabela

    Central de documentação

    Object Storage Service:Definir configuração de manutenção da tabela

    Última atualização: Jul 03, 2026

    Define a configuração de manutenção automática de uma tabela Iceberg, incluindo compactação e gerenciamento de snapshots.

    Observações de uso

    • O parâmetro --type aceita dois tipos de manutenção:

      • icebergCompaction: mescla arquivos de dados pequenos em arquivos maiores para melhorar o desempenho das consultas.

      • icebergSnapshotManagement: exclui snapshots expirados para liberar espaço de armazenamento.

    • O parâmetro --value recebe uma string JSON. Forneça o JSON diretamente ou carregue-o de um arquivo local com o prefixo file://.

    • Execute este comando separadamente para cada tipo de manutenção. Para configurar compactação e gerenciamento de snapshots, execute-o duas vezes.

    Sintaxe do comando

    ossutil tables-api put-table-maintenance-configuration --table-bucket-arn value --namespace value --name value --type value --value value [flags]

    Parâmetro

    Tipo

    Descrição

    --name

    string

    Nome da tabela. Obrigatório.

    --namespace

    string

    Namespace da tabela. Obrigatório.

    --table-bucket-arn

    string

    ARN do Table Bucket no formato acs:osstables:{region}:{uid}:bucket/{bucket-name}. Obrigatório.

    --type

    string

    Tipo de manutenção. Valores válidos: icebergCompaction e icebergSnapshotManagement. Obrigatório.

    --value

    string

    Configuração de manutenção em formato JSON. Forneça a string JSON diretamente ou especifique o caminho de um arquivo local com o prefixo file://. Obrigatório.
    Nota

    • O comando put-table-maintenance-configuration corresponde à operação da API PutTableMaintenanceConfiguration. Para obter detalhes sobre os parâmetros da API, consulte PutTableMaintenanceConfiguration.

    • Para obter a lista de opções globais de linha de comando compatíveis, consulte Opções globais do ossutil.

    Exemplos

    • Ative a compactação com tamanho de arquivo alvo de 512 MB.

      ossutil tables-api put-table-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --type icebergCompaction --value '{"status":"enabled","settings":{"targetFileSizeMB":512}}'

    • Ative a limpeza de snapshots para reter os 5 snapshots mais recentes e remover os anteriores a 168 horas (7 dias).

      ossutil tables-api put-table-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --type icebergSnapshotManagement --value '{"status":"enabled","settings":{"minSnapshotsToKeep":5,"maxSnapshotAgeHours":168}}'

    • Carregue a configuração de manutenção de um arquivo JSON local com o prefixo file://.

      ossutil tables-api put-table-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --type icebergCompaction --value file://compaction-config.json

    • Desative a compactação de uma tabela Iceberg.

      ossutil tables-api put-table-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --type icebergCompaction --value '{"status":"disabled"}'