Compartilhar via


cacheTable

Armazena em cache a tabela especificada na memória ou com determinado nível de armazenamento. MEMORY_AND_DISK padrão.

Sintaxe

cacheTable(tableName: str, storageLevel: StorageLevel = None)

Parâmetros

Parâmetro Tipo Descrição
tableName str Nome da tabela a ser obtido. Pode ser qualificado com o nome do catálogo.
storageLevel StorageLevelopcional Nível de armazenamento a ser definido para persistência.

Observações

Os dados armazenados em cache são compartilhados em todas as sessões do Spark no cluster.

Exemplos

_ = spark.sql("DROP TABLE IF EXISTS tbl1")
_ = spark.sql("CREATE TABLE tbl1 (name STRING, age INT) USING parquet")
spark.catalog.cacheTable("tbl1")

# or

spark.catalog.cacheTable("tbl1", StorageLevel.OFF_HEAP)

# Throw an analysis exception when the table does not exist.
spark.catalog.cacheTable("not_existing_table")
# Traceback (most recent call last):
#     ...
# AnalysisException: ...

# Using the fully qualified name for the table.
spark.catalog.cacheTable("spark_catalog.default.tbl1")
spark.catalog.uncacheTable("tbl1")
_ = spark.sql("DROP TABLE tbl1")