Skip to content

Commit

Permalink
Add iceberg connector doc
Browse files Browse the repository at this point in the history
  • Loading branch information
ChunxuTang authored and zhenxiao committed May 26, 2021
1 parent 1463e68 commit 127949e
Show file tree
Hide file tree
Showing 2 changed files with 54 additions and 0 deletions.
1 change: 1 addition & 0 deletions presto-docs/src/main/sphinx/connector.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ from different data sources.
connector/elasticsearch
connector/hive
connector/hive-security
connector/iceberg
connector/jmx
connector/kafka
connector/kafka-tutorial
Expand Down
53 changes: 53 additions & 0 deletions presto-docs/src/main/sphinx/connector/iceberg.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
=================
Iceberg Connector
=================

Overview
--------

The Iceberg connector allows querying data stored in Iceberg tables.

.. note::

It is recommended to use Iceberg 0.9.0 or later.

Configuration
-------------

To configure the Iceberg connector, create a catalog properties file
``etc/catalog/iceberg.properties`` with the following contents,
replacing the properties as appropriate:

.. code-block:: none
connector.name=iceberg
hive.metastore.uri=hostname:port
Configuration Properties
------------------------

The following configuration properties are available:

======================= ==================================
Property Name Description
======================= ==================================
``hive.metastore.uri`` The URI(s) of the Hive metastore.
======================= ==================================

``hive.metastore.uri``
^^^^^^^^^^^^^^^^^^^^^^
The URI(s) of the Hive metastore to connect to using the Thrift protocol.
If multiple URIs are provided, the first URI is used by default and the
rest of the URIs are fallback metastores. This property is required.
Example: ``thrift://192.0.2.3:9083`` or ``thrift://192.0.2.3:9083,thrift://192.0.2.4:9083``

Iceberg Configuration Properties
--------------------------------

============================== ================================================= ============
Property Name Description Default
============================== ================================================= ============
``iceberg.file-format`` The storage file format for Iceberg tables. ``PARQUET``

``iceberg.compression-codec`` The compression codec to use when writing files. ``GZIP``
============================== ================================================= ============

0 comments on commit 127949e

Please sign in to comment.