Skip to content

docs(native): Update documentation for Hive Connector #26658

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

docs(native): Update documentation for Hive Connector #26658

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8da4780
[26101]Invalidate Directory List Cache changes
vrama32 Nov 19, 2025
fa1ea5e
Merge branch 'master' into RemoveDirectoryListCacheHiveDoc
vrama32 Nov 20, 2025
dde4794
Incorporated review comment
vrama32 Nov 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 7 additions & 14 deletions presto-docs/src/main/sphinx/connector/hive.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1040,13 +1040,16 @@ Sync Partition Metadata
Invalidate Directory List Cache
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* ``system.invalidate_directory_list_cache()``
Invalidating directory list cache is useful when the files are added or deleted in the cache directory path and you want to make the changes visible to Presto immediately.
There are a couple of ways for invalidating this cache:

* The Hive connector exposes a procedure over JMX (``com.facebook.presto.hive.CachingDirectoryLister#flushCache``) to invalidate the directory list cache. You can call this procedure to invalidate the directory list cache by connecting via jconsole or jmxterm. This procedure flushes all the cache entries.

Flush full directory list cache.
* The Hive connector exposes ``system.invalidate_directory_list_cache`` procedure which gives the flexibility to invalidate the list cache completely or partially as per the requirement and can be invoked in various ways.

* ``system.invalidate_directory_list_cache(directory_path)``
* ``system.invalidate_directory_list_cache()`` : Flush full directory list cache.

Invalidate directory list cache for specified directory_path.
* ``system.invalidate_directory_list_cache(directory_path)`` : Invalidate directory list cache for specified directory_path.

Invalidate Metastore Cache
^^^^^^^^^^^^^^^^^^^^^^^^^^
Expand Down Expand Up @@ -1092,16 +1095,6 @@ There are a couple of ways for invalidating this cache and are listed below -

* The Hive connector exposes ``system.invalidate_metastore_cache`` procedure which enables users to invalidate the metastore cache completely or partially as per the requirement and can be invoked with various arguments. See `Invalidate Metastore Cache`_ for more information.

How to invalidate directory list cache?
---------------------------------------

Invalidating directory list cache is useful when the files are added or deleted in the cache directory path and you want to make the changes visible to Presto immediately.
There are a couple of ways for invalidating this cache and are listed below -

* The Hive connector exposes a procedure over JMX (``com.facebook.presto.hive.CachingDirectoryLister#flushCache``) to invalidate the directory list cache. You can call this procedure to invalidate the directory list cache by connecting via jconsole or jmxterm. This procedure flushes all the cache entries.

* The Hive connector exposes ``system.invalidate_directory_list_cache`` procedure which gives the flexibility to invalidate the list cache completely or partially as per the requirement and can be invoked in various ways. See `Invalidate Directory List Cache`_ for more information.

Examples
--------

Expand Down
Loading