DROP SERVICE

Removes the specified Snowpark Container Services service from the current or specified schema. The containers for the service are terminated.

See also:

CREATE SERVICE , ALTER SERVICE, SHOW SERVICES , DESCRIBE SERVICE

Syntax

DROP SERVICE [ IF EXISTS ] <name> [ FORCE ]
Copy

Required parameters

name

Specifies the identifier for the service to be dropped.

If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.

For more information, see Identifier requirements.

Optional parameters

FORCE

Drops the service (including job services) and the associated block storage volumes.

If FORCE is not specified and the service uses a block storage volume an error is returned.

Access control requirements

A role used to execute this operation must have the following privileges at a minimum:

Privilege

Object

Notes

OWNERSHIP

Service

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

For instructions on creating a custom role with a specified set of privileges, see Creating custom roles.

For general information about roles and privilege grants for performing SQL actions on securable objects, see Overview of Access Control.

Usage notes

  • When the IF EXISTS clause is specified and the target object doesn’t exist, the command completes successfully without returning an error.

Examples

The following example drops the service named my_tutorial:

DROP SERVICE my_tutorial;
Copy
+-----------------------------------+
| status                            |
|-----------------------------------|
| MY_TUTORIAL successfully dropped. |
+-----------------------------------+
Language: English