Skip to main content

# kater test update

Marks a draft test as checked, so that the test counts toward the model's readiness.

{/* Written by apps/landing-page/scripts/docs/write_cli_reference.py from the kater CLI's own help and scripts/docs/cli-reference.md. Do not edit it by hand: change those, then run the script. */}

Use it after you compare the test's answer with a number that you trust. It takes `draft: true` out of the test and changes nothing else.

## Examples

```bash
# Mark a test of the shared ad_reporting model as checked
kater test update clicks_impressions_by_platform --model semantic.ad_reporting --checked
# Name the file, when your own tests and the shared layer's both have a test of this name
kater test update clicks_impressions_by_platform --model semantic.ad_reporting --checked --file connections/snowflake_prod_connection/modeling/kater_objects/tests/ad_reporting.sql
```

## Arguments

<div class="cli-options">

| Argument | Description |
| --- | --- |
| `<name>` | The test's name. |

</div>

## Options

<div class="cli-options">

| Option | Description |
| --- | --- |
| `--connection <name>` | The connection, by its folder name under `connections/`. Leave it out when `--file` names the connection, or when only one connection has the `--model`. |
| `--model <model>` | Required. The model that the test checks, such as `semantic.ad_reporting`. |
| `--checked` | Required. Takes out `draft: true`. Give it after you check the test's answer. |
| `--file <file>` | The test file, by its path. Give it when more than one of the model's test files has a test of this name, such as the shared layer's and your own. |

</div>

It also takes the [global options](https://kater.ai/docs/cli-reference/global-options/) `--json`, `--kater-root`, `--scope` and `--help`.

## See also

- [`kater test`](https://kater.ai/docs/cli-reference/test/)
- [All commands](https://kater.ai/docs/cli-reference/kater/)

On this page

Examples
Arguments
Options
See also

Kater CLI Build and check test

kater test update

Marks a draft test as checked, so that the test counts toward the model's readiness.

Use it after you compare the test’s answer with a number that you trust. It takes draft: true out of the test and changes nothing else.

Examples

# Mark a test of the shared ad_reporting model as checked
kater test update clicks_impressions_by_platform --model semantic.ad_reporting --checked
# Name the file, when your own tests and the shared layer's both have a test of this name
kater test update clicks_impressions_by_platform --model semantic.ad_reporting --checked --file connections/snowflake_prod_connection/modeling/kater_objects/tests/ad_reporting.sql

Arguments

Argument	Description
`<name>`	The test’s name.

Options

Option	Description
`--connection <name>`	The connection, by its folder name under `connections/`. Leave it out when `--file` names the connection, or when only one connection has the `--model`.
`--model <model>`	Required. The model that the test checks, such as `semantic.ad_reporting`.
`--checked`	Required. Takes out `draft: true`. Give it after you check the test’s answer.
`--file <file>`	The test file, by its path. Give it when more than one of the model’s test files has a test of this name, such as the shared layer’s and your own.

It also takes the global options --json, --kater-root, --scope and --help.

See also