Skip to main content
Version: 0.19.3

Starting the client

Once your Python environment is ready, run:

from featurestore import Client
client = Client(url, secure=False, root_certificates=None, config=config)

or

from featurestore import Client
with Client(url, secure=False, root_certificates=None, config=config) as client:
...

where:

  • url - the endpoint address of the Feature Store Server as a string (usually in ip:port format).
  • secure - turn on secure connection for Feature Store API. If you run Feature Store behind nginx-ingress (which requires tls connection) make sure the secure flag is set to True. Client may also require root certificates.
  • root_certificates - root certificates file location as a string or None to retrieve them from a default location chosen by gRPC runtime.
  • config - Additional client configuration. If not specified, defaults are used.

The following API can be used to enable or disable interactive logging. Logging is enabled by default.

client.show_progress(False)
note

It's good practice to close the connection after all action has proceeded. You should call client.close() or use the context manager.

Client configuration

We can pass a config to the client constructor. The following examples show how to create the configuration and explain what options can be specified.

config = ClientConfig(wait_for_backend=True, timeout=<value in seconds>, log_level=INFO)
  • wait_for_backend - if False, client does not wait for the Feature Store Backend to be ready.
  • timeout - client-side timeout in seconds to terminate long waiting grpc calls.
  • log_level - Logging level to be used on the Python client. Supported values are CRITICAL, ERROR, WARNING, INFO and DEBUG.
note

The client configuration is stored by default in the user's home directory. You can change this location by setting the FEATURESTORE_USER_CONFIG environmental variable to the desired location before starting the client.

Obtaining version

Both client and server version is printed out after client is created to standard output.

Versions can also be obtained by calling the following method:

client.get_version()

Open Web UI

This method will opens the Feature Store Web UI.

client.open_website()

Feedback