# ExternalStage

[Snowflake Documentation](https://docs.snowflake.com/en/sql-reference/sql/create-stage)

Manages external stages in Snowflake, which are used to reference external storage locations.

## Examples

### Python

```python
external_stage = ExternalStage(
    name="some_external_stage",
    url="https://example.com/storage",
    owner="SYSADMIN",
    storage_integration="some_integration"
)
```

### YAML

```yaml
stages:
  - name: some_external_stage
    type: external
    url: https://example.com/storage
    owner: SYSADMIN
    storage_integration: some_integration
```

## Fields

* `name` (string, required) - The name of the external stage.
* `url` (string, required) - The URL pointing to the external storage location.
* `owner` (string or [Role](/titan-core/resources/role.md)) - The owner role of the external stage. Defaults to "SYSADMIN".
* `storage_integration` (string) - The name of the storage integration used with this stage.
* `credentials` (dict) - The credentials for accessing the external storage, if required.
* `encryption` (dict) - The encryption settings used for data stored in the external location.
* `directory` (dict) - Settings related to directory handling in the external storage.
* `tags` (dict) - Tags associated with the external stage.
* `comment` (string) - A comment about the external stage.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://titan-core.gitbook.io/titan-core/resources/external_stage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.