docs-v2/content/shared/influxdb3-cli/test/schedule_plugin.md

2.3 KiB

The influxdb3 test schedule_plugin command tests a schedule plugin.
Use this command to verify plugin behavior without creating a trigger.

Usage

influxdb3 test schedule_plugin [OPTIONS] --database <DATABASE_NAME> <FILENAME>

Arguments

  • FileName: Path to the local plugin file (usually ends in .py)

Options

Option Flag Description
-H --host Host URL of the running {{< product-name >}} server (default: http://127.0.0.1:8181)
-d --database ({{< req >}}) Name of the database to operate on
--token ({{< req >}}) Authentication token
--tls-ca Path to a custom TLS certificate authority (for testing or self-signed certificates)
-h --help Print help information
--help-all Print detailed help information

Option environment variables

You can use the following environment variables to set command options:

Environment Variable Corresponding Option
INFLUXDB3_HOST_URL --host
INFLUXDB3_DATABASE_NAME --database
INFLUXDB3_AUTH_TOKEN --token

Examples

In the examples below, replace the following:

  • {{% code-placeholder-key %}}DATABASE_NAME{{% /code-placeholder-key %}}: Your target database
  • {{% code-placeholder-key %}}AUTH_TOKEN{{% /code-placeholder-key %}}: Your authentication token
  • {{% code-placeholder-key %}}PLUGIN_FILENAME{{% /code-placeholder-key %}}: Plugin filename (with path)

{{% code-placeholders "DATABASE_NAME|AUTH_TOKEN|PLUGIN_FILENAME" %}}

Test a schedule plugin

influxdb3 test schedule_plugin \
  --database DATABASE_NAME \
  --token AUTH_TOKEN \
  PLUGIN_FILENAME.py

{{% /code-placeholders %}}