The Featureform CLI allows you to describe, list, and monitor your resources.
The apply command submits resource definitions to the Featureform instance.
The argument can either be a path to a local file or the url of a hosted file. Multiple files can be included at a time.
featureform apply --host $FEATUREFORM_HOST --cert $FEATUREFORM_CERT
Upon success, all definitions in the definitions.py (or whatever you choose to call it) file will be sent to the Featureform instance, logged in the metadata, and materialized with the registered providers.
After applying new resource definitions, you can use the GET command to see the status of the resources you applied. A resource with the status READY is available for serving.
The DASH command is used to access the featureform dashboard. It returns a URL to the locally hosted dashboard.
The dashboard can be viewed at
http://localhost:3000 in your browser
The Featureform dashboard:
Each button on the dashboard redirects you to a list of resources of that resource type.
List of registered features
Each resource can then be clicked on to learn more.
The GET command displays status, variants, and other metadata on a resource.
featureform get RESOURCE_TYPE NAME [VARIANT] --host $FEATUREFORM_HOST --cert $FEATUREFORM_CERT
RESOURCE_TYPE (required) can be:
feature - machine learning features
label - machine learning labels
training-set - set of features and one label for training ML models
user - registered users in your instance
entity - identifier for a source of features or labels (akin to a primary key)
model - registered machine learning models which training sets and features are fed to
provider - registered 3rd party providers which store your data
source - files, tables, or transformations that features, labels and training sets source from
NAME is the name of the resource type to be queried.
VARIANT is optional, for when information on a specific variant is needed.
Example: Getting a User
The commands are both valid ways to retrieve information on the user “featureformer”.
The first is with certification. The second without; the —insecure flag disables the need for the —cert flag
featureform get user featureformer --host $FEATUREFORM_HOST --cert $FEATUREFORM_CERT
featureform get user featureformer --insecure --host $FEATUREFORM_HOST
Either command returns the following output.
USER NAME: featureformer
NAME VARIANT TYPE
avg_transactions quickstart feature
fraudulent quickstart label
fraud_training quickstart training set
transactions kaggle source
average_user_transaction quickstart source
Listed below the user are all the resources registered to that user.
Example: Getting a Resource
The following command shows how to retrieve information on a specific resource, a feature named “avg_transactions”.
featureform get feature avg_transactions --host $FEATUREFORM_HOST --cert $FEATUREFORM_CERT
prodThis would be the output:
Example: Getting a Resource Variant
The command below retrieves information on the specific variant of the feature ”avg_transactions”, “quickstart”
featureform get feature avg_transactions quickstart --host $FEATUREFORM_HOST --cert $FEATUREFORM_CERT
Listed below are the metadata on that variant, as well as its source and the training sets it belongs to.
The LIST command displays the name, variant and status of all the resources of that resource type.
featureform list RESOURCE_TYPE --host $FEATUREFORM_HOST –cert $FEATUREFORM_CERT
RESOURCE_TYPE (required) can be:
features - machine learning features
labels - machine learning labels
training-sets - set of features and one label for training ML models
users - registered users in your instance
entities - identifier for a source of features or labels (akin to a primary key)
models - registered machine learning models which training sets and features are fed to
providers - registered 3rd party providers which store your data
sources - files, tables, or transformations that features, labels and training sets source from
Example: Getting the list of users
featureform list users --host $FEATUREFORM_HOST --cert $FEATUREFORM_CERT
featureform list users --insecure --host $FEATUREFORM_HOST
The commands are both valid ways to retrieve a list of users. The first is when the user uses a self-signed cert.
The following uses the local flag to access resources created and stored in localmode:
featureform list users –-local
The above commands return the following list of users which have been registered:
Example: Getting the list of resources of a given type
featureform list features --host $FEATUREFORM_HOST --cert $FEATUREFORM_CERT
featureform list features --insecure --host $FEATUREFORM_HOST
In local mode:
featureform list features –-local
The given commands return the list of registered features and their variants
NAME VARIANT STATUS
avg_transactions quickstart(default) ready