SHOW STREAMLITS¶

Atenção

Este recurso está disponível para contas em regiões comerciais do AWS e Microsoft Azure. AWS PrivateLink não é suportado.

Lista os objetos Streamlit para os quais você tem privilégios de acesso.

O comando pode ser usado para listar os objetos Streamlit para o banco de dados ou esquema atual/especificado, ou em toda a sua conta.

Consulte também: CREATE STREAMLIT, DESCRIBE STREAMLIT, ALTER STREAMLIT, DROP STREAMLIT

Sintaxe¶

SHOW [ TERSE ] STREAMLITS [ LIKE '<pattern>' ]
                          [ IN
                                {
                                  ACCOUNT                   |

                                  DATABASE                  |
                                  DATABASE <db_name>        |

                                  SCHEMA
                                  SCHEMA <schema_name>      |
                                  <schema_name>             |
                                }
                          ]
                          [ LIMIT <rows> [ FROM '<name_string>' ]

Copy

Parâmetros¶

TERSE

Retorna apenas um subconjunto das colunas de saída:

created_on
name
database_name
schema_name
url_id

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

[ IN ... ]

Opcionalmente, especifica o escopo do comando. Especifique um dos seguintes:

ACCOUNT

Retorna registros para toda a conta.

DATABASE, . DATABASE db_name

Retorna registros do banco de dados atual em uso ou de um banco de dados especificado (db_name).

Se você especificar DATABASE sem db_name e nenhum banco de dados estiver em uso, a palavra-chave não terá efeito sobre a saída.

SCHEMA, . SCHEMA schema_name, . schema_name

Retorna registros do esquema atual em uso ou de um esquema especificado (schema_name).

SCHEMA é opcional se um banco de dados estiver em uso ou se você especificar o schema_name totalmente qualificado (por exemplo, db.schema).

Se nenhum banco de dados estiver em uso, a especificação SCHEMA não terá efeito sobre a saída.

Padrão: depende se a sessão tem ou não um banco de dados em uso no momento:

Banco de dados: DATABASE é o padrão (ou seja, o comando retorna os objetos nos quais você tem privilégios para visualizar no banco de dados).
Sem banco de dados: ACCOUNT é o padrão (ou seja, o comando retorna os objetos que você tem privilégios de visualização em sua conta).

LIMIT rows [ FROM 'name_string' ]

Opcionalmente, limita o número máximo de linhas retornadas, ao mesmo tempo em que permite a «paginação» dos resultados. O número real de linhas retornadas pode ser menor que o limite especificado. Por exemplo, o número de objetos existentes é menor que o limite especificado.

A subcláusula opcional FROM 'name_string' serve efetivamente como um “cursor” para os resultados. Isso permite obter o número especificado de linhas seguindo a primeira linha cujo nome do objeto corresponde à cadeia de caracteres especificada:

A cadeia de caracteres deve ser delimitada entre aspas simples e há distinção entre maiúsculas e minúsculas.
A cadeia de caracteres não precisa incluir o nome completo do objeto; também é permitido usar nomes parciais.

Padrão: nenhum valor (nenhum limite é aplicado à saída)

Nota

Para comandos SHOW que oferecem suporte às cláusulas FROM 'name_string' e STARTS WITH 'name_string', você pode combinar ambas as cláusulas na mesma instrução. No entanto, ambas as condições devem ser cumpridas ou elas se cancelam mutuamente e nenhum resultado é retornado.

Além disso, os objetos são devolvidos em ordem lexicográfica por nome, portanto FROM 'name_string' só retorna linhas com um valor lexicográfico maior que as linhas retornadas por STARTS WITH 'name_string'.

Por exemplo:

... STARTS WITH 'A' LIMIT ... FROM 'B' não retornaria nenhum resultado.
... STARTS WITH 'B' LIMIT ... FROM 'A' não retornaria nenhum resultado.
... STARTS WITH 'A' LIMIT ... FROM 'AB' retornariam resultados (se alguma linha corresponder às cadeias de caracteres de entrada).

Notas de uso¶

O comando não lista os objetos Streamlit que foram descartados.
O comando não precisa de um warehouse em funcionamento para ser executado.

Saída¶

A saída do comando fornece informações sobre um objeto Streamlit nas seguintes colunas:

Coluna	Descrição
`created_on`	Data e hora em que o objeto Streamlit foi criado.
`name`	Nome do objeto Streamlit.
`database_name`	Banco de dados no qual o objeto Streamlit é armazenado.
`schema_name`	Esquema no qual o objeto Streamlit é armazenado.
`owner`	Função proprietária do objeto Streamlit.
`comment`	Comentário para o objeto Streamlit.
`root_location`	Local raiz dos arquivos de aplicativo do objeto Streamlit.
`main_file`	Nome do arquivo Python do objeto Streamlit.
`query_warehouse`	Warehouse onde são executadas as consultas emitidas pelo aplicativo Streamlit.
`url_id`	ID exclusivo associado ao objeto Streamlit.
`owner_role_type`	O tipo de função que possui o objeto, `ROLE` ou `DATABASE_ROLE`. . Se um Snowflake Native App possuir o objeto, o valor será `APPLICATION`. . Snowflake retornará NULL se você excluir o objeto porque um objeto excluído não tem função de proprietário.