Todos os produtos
Search
Central de documentação

MaxCompute:Opções de configuração

Última atualização: Jun 26, 2026

Use odps.options para ler e definir opções de configuração do PyODPS em tempo de execução.

from odps import options

# Set the lifecycle for all output tables
options.lifecycle = 30

# Use bytes instead of Unicode for STRING data
options.tunnel.string_as_binary = True

# Increase the sort limit for PyODPS DataFrame operations
options.df.odps.sort.limit = 100000000

Configurações gerais

Opção

Tipo

Descrição

Padrão

end_point

String

Endpoint do MaxCompute.

None

default_project

String

Projeto padrão.

None

log_view_host

String

Nome do host do Logview.

None

log_view_hours

Integer

Período de retenção do Logview. Unidade: horas.

24

local_timezone

None/Boolean/String

Fuso horário para valores datetime. True usa o fuso horário local do sistema. False usa UTC. Também aceita uma string de fuso horário pytz.

None

lifecycle

Integer

Ciclo de vida de todas as tabelas.

None

temp_lifecycle

Integer

Ciclo de vida das tabelas temporárias.

1

biz_id

String

ID do usuário.

None

verbose

Boolean

Indica se os logs são impressos.

False

verbose_log

Object

Receptor de log.

None

chunk_size

Integer

Tamanho do buffer de gravação.

1496

retry_times

Integer

Número de tentativas de requisição.

4

pool_connections

Integer

Conexões em cache no pool de conexões.

10

pool_maxsize

Integer

Capacidade máxima do pool de conexões.

10

connect_timeout

Integer

Tempo limite de conexão.

5

read_timeout

Integer

Tempo limite de leitura.

120

api_proxy

String

Servidor proxy de API.

None

data_proxy

String

Servidor proxy de dados.

None

completion_size

Integer

Máximo de itens retornados na conclusão automática de nomes de objetos.

10

notebook_repr_widget

Boolean

Uso de gráficos interativos em ambientes Notebook.

True

sql.settings

Dictionary

Hints globais para MaxCompute SQL.

None

sql.use_odps2_extension

Boolean

Ativa a extensão de linguagem do MaxCompute 2.0.

False

Configurações de upload e download de dados

Opção

Tipo

Descrição

Padrão

tunnel.endpoint

String

Endpoint do MaxCompute Tunnel.

None

tunnel.use_instance_tunnel

Boolean

Usa o InstanceTunnel para obter resultados de execução.

True

tunnel.limit_instance_tunnel

None/Boolean

Limita os registros recuperados pelo InstanceTunnel.

None

tunnel.string_as_binary

Boolean

Usa bytes em vez de Unicode para dados STRING.

False

Configurações de DataFrame

Opção

Tipo

Descrição

Padrão

interactive

Boolean

Indica se os DataFrames estão em ambiente interativo. Detectado automaticamente.

Depende do valor detectado.

df.analyze

Boolean

Habilita funções não nativas do MaxCompute.

True

df.optimize

Boolean

Ativa a otimização completa de DataFrame.

True

df.optimizes.pp

Boolean

Habilita a otimização de predicate pushdown.

True

df.optimizes.cp

Boolean

Habilita a otimização de column pruning.

True

df.optimizes.tunnel

Boolean

Habilita a otimização de tunnel.

True

df.quote

Boolean

Delimita nomes de campos e tabelas com crases () no MaxCompute SQL.

True

df.libraries

String

Nome do resource da biblioteca de terceiros usada nas operações de DataFrame.

None

df.supersede_libraries

Boolean

Usa uma versão do NumPy carregada manualmente em vez da versão fornecida pelo serviço.

False

df.odps.sort.limit

Integer

Limite padrão de itens adicionados durante a ordenação de DataFrames.

10000

Configurações de machine learning

Opção

Tipo

Descrição

Padrão

ml.xflow_settings

Dictionary

Configuração de execução do XFlow.

None

ml.xflow_project

String

Nome padrão do projeto XFlow.

algo_public

ml.use_model_transfer

Boolean

Usa o ModelTransfer para recuperar arquivos PMML (Predictive Model Markup Language).

False

ml.model_volume

String

Nome do volume usado pelo ModelTransfer.

pyodps_volume