- Categorias:
Funções do sistema (Informação)
SYSTEM$SHOW_BUDGETS_FOR_RESOURCE¶
Retorna uma cadeia de caracteres que contém uma lista dos orçamentos que rastreiam um recurso especificado (por exemplo, uma tabela ou um esquema). Atualmente, um recurso pode ser rastreado por um orçamento.
- Consulte também:
Sintaxe¶
SYSTEM$SHOW_BUDGETS_FOR_RESOURCE( '<resource_domain>' , '<resource_name>' )
Argumentos¶
'resource_domain'
Domínio do recurso. Especifique um dos seguintes valores:
compute_pool
database
materialized_view
pipe
schema
table
task
warehouse
'resource_name'
Nome do recurso (por exemplo, o nome da tabela).
Retornos¶
Retorna um valor VARCHAR que contém a lista delimitada por vírgulas dos nomes totalmente qualificados dos orçamentos para o recurso. A lista é colocada entre colchetes.
Se não houver orçamentos rastreando o recurso especificado, a função retornará uma cadeia de caracteres contendo um par vazio de colchetes ([]
).
Notas de uso¶
Atualmente, um recurso pode ser rastreado por apenas um orçamento.
Se um recurso foi adicionado automaticamente a um orçamento (por exemplo, porque uma tabela está em um banco de dados que foi adicionado a um orçamento), a função retorna esse orçamento. Ao contrário do método <budget_name>!GET_LINKED_RESOURCES, essa função permite que você determine se um recurso foi adicionado automaticamente a um orçamento.
Exemplos¶
O exemplo a seguir retorna a lista de orçamentos que rastreiam o esquema denominado my_db.my_schema
:
SELECT SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('SCHEMA', 'my_db.my_schema');
+---------------------------------------------------------------+
| SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('SCHEMA', 'MY_DB.MY_SCHEMA') |
|---------------------------------------------------------------|
| [BUDGETS_DB.BUDGETS_SCHEMA.MY_BUDGET] |
+---------------------------------------------------------------+
O exemplo a seguir retorna a lista de orçamentos que rastreiam a tabela denominada my_db.my_schema.my_table
. Neste exemplo, a tabela não é monitorada por nenhum orçamento, portanto, a função retorna uma lista vazia.
SELECT SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('TABLE', 'my_db.my_schema.my_table');
+-----------------------------------------------------------------------+
| SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('TABLE', 'MY_DB.MY_SCHEMA.MY_TABLE') |
|-----------------------------------------------------------------------|
| [] |
+-----------------------------------------------------------------------+