URI cheat sheet
Deephaven servers can share tables through URIs. resolve turns a URI into a live table that updates as the remote table changes.
Important
resolve connects to the remote server with anonymous authentication. It does not support pre-shared key (PSK) authentication, which Deephaven servers use by default. The remote server must therefore allow anonymous authentication, or resolution fails. GitHub issues #5383 and #3421 track this limitation.
Syntax
dh+plainconnects without encryption.dhconnects with TLS.<host>is the remote server's Docker container name, Docker Compose service name, hostname, or IP address.<port>is optional. When the URI omits it, the connection uses port10000fordh+plainand port443fordh.scope/<table_name>refers to a table in the remote server's query scope, where<table_name>is the name of the variable that holds it.app/<app_id>/field/<field_name>refers to a table that an Application Mode application exports as a field.<app_id>is the application's ID, and<field_name>is the field's name.- Without a host (
dh:///scope/<table_name>ordh:///app/<app_id>/field/<field_name>),resolvereads from the resolving server's own query scope or applications.
Share tables between Docker containers
To resolve a table from a server in another Docker container on the same user-defined network:
- Use the remote server's container name as the host.
- With Docker Compose, use the remote server's service name. Compose creates the shared network.
- If you include a port, use the port the remote server listens on inside its container, not the port mapped to it on the host.
To put the containers on one network without Docker Compose, see Without Docker Compose.
This example resolves my_table from the server in the container named table-producer:
Share tables across a network
To resolve a table from a server on another machine:
- Use the remote server's IP address or hostname as the host.
- Add the port when the remote server does not listen on the scheme's default port.
- Use
dhto encrypt the connection. - Expose the remote server only on a network you trust. It must allow anonymous authentication, so anyone who can reach it can connect.
This example resolves my_table by IP address and port, by hostname and port, and over TLS on the default port 443:
Resolve an Application Mode field
To resolve a table that an Application Mode application exports as a field, use the app/<app_id>/field/<field_name> path in place of scope/<table_name>. This example resolves the field my_field that the application my_app exports on the server in the container named table-producer:
Resolve CSV and Parquet files
resolve also reads CSV and Parquet files from the resolving server's file system, and CSV files over HTTP or HTTPS:
csv:///data/file.csvreads a CSV file.csv+https://host/path/file.csvreads a CSV file over HTTPS (csv+httpfor HTTP).parquet:///data/file.parquetreads a Parquet file or a directory of Parquet files.