Connecting to Apache Hudi
It is also possible to query existing data on Hudi directly without loading it to PuppyGraph. Here is an demo of the feature.
In the demo, the Hudi data source stores people and referral information. To query the data as a graph, we model people as vertices and the referral relationship between people as edges.
Prerequisites
The demo assumes that PuppyGraph has been deployed at localhost
according to the instruction in Launching PuppyGraph from AWS Marketplace or Launching PuppyGraph in Docker.
In this demo, we use the username puppygraph
and password puppygraph123
.
Data Preparation (Optional)
The demo uses people and referral information as shown above.
Here is the shell command to start a SparkSQL instance for data preparation assuming that the hudi data are stored on HDFS at 172.31.19.123:9000
and the Hive metastore is at 172.31.31.125:9083
.
Now we can use the following SparkSQL query to create data in the database hudi_onhdfs
. The catalog name is puppy_hudi
as specified in the command above.
Upload the schema
Now the data are ready in Hudi. We need a PuppyGraph schema before querying it. Let's create a schema file hudi.json
:
Here are some notes on this schema:
A catalog
catalog_test
is added to specify the remote data source in Hudi. Note thehiveMetastoreUrl
field has the same value as the one we used to create data.The label of the vertices and edges do not have to be the same as the names of corresponding tables in Hudi. There is a
mappedTableSource
field in each of the vertex and edge types specifying the actual schema (onhdfs
) and table (referral
).Additionally, the
mappedTableSource
marks meta columns in the tables. For example, the fieldsfrom
andto
describe which columns in the table form the endpoints of edges.
PuppyGraph supports query Iceberg / Hudi / Delta Lake with metastore: Hive metastore/ AWS Glue and with storage: HDFS/ AWS S3/ MinIO.
You can refer to catalog configuration examples we provide: #examples.
For more catalog parameters details, please refer to Data Lake Catalog.
Now we can upload the schema file hudi.json
to PuppyGraph with the following shell command, assuming that the PuppyGraph is running on localhost
:
Query the data
Connecting to PuppyGraph at http://localhost:8081 and start gremlin console from the "Query" section:
Now we have connected to the Gremlin Console. We can query the graph:
\
Last updated