Categorias:

Funções do sistema (Controle do sistema)

SYSTEM$CREATE_BILLING_EVENTS

Cria vários eventos faturáveis que rastreiam o uso do consumidor de aplicativos monetizados instalados. Use essa função do sistema quando você precisar exceder o limite de frequência de um evento por minuto de SYSTEM$CREATE_BILLING_EVENT. Esta função do sistema só pode ser chamada a partir de um aplicativo instalado em uma conta de consumidor.

Sintaxe

SYSTEM$CREATE_BILLING_EVENTS('<json_array_of_events>')
Copy

Argumentos

'json_array_of_events'

Uma STRING contendo uma matriz de objetos JSON. Cada objeto especifica um evento de faturamento.

Cada objeto JSON contém os seguintes pares chave-valor:

{
  "class": "my_class",
  "subclass": "my_subclass",
  "start_timestamp": 1730825611,
  "timestamp": 1730826611,
  "base_charge": 1.00,
  "objects": "[\"my_schema.my_udf\"]",
  "additional_info": "my_additional_info"
}
Copy

A tabela a seguir descreve esses pares chave-valor:

Par chave-valor

Tipo

Descrição

"class"

STRING

Identificador para a classe de evento personalizada.

"subclass"

STRING

Identificador para a subclasse de evento personalizado. Este campo é usado apenas pelo provedor.

"start_timestamp"

INTEGER

A hora de início (UTC) do evento como um carimbo de data/hora Unix em milissegundos.

"timestamp"

INTEGER

O carimbo de data/hora (UTC) quando o evento foi criado como um carimbo de data/hora Unix em milissegundos.

"base_charge"

DOUBLE

O valor em dólares US a ser cobrado pelo evento faturável. O valor deve ser maior que zero, menor que 99.999,99 e não deve exceder duas casas decimais de precisão. Por exemplo, 1.00 ou 0.07.

"objects"

STRING

Uma matriz de cadeia de caracteres JSON contendo nomes de objetos totalmente qualificados que se aplicam ao evento.

"additional_info"

STRING

A cadeia de caracteres JSON de pares chave-valor que o provedor pode usar para enviar informações adicionais.

Retornos

Esta função retorna as seguintes mensagens de status:

Mensagem de status

Descrição

Sucesso

Indica que o evento faturável foi criado com sucesso.

Parâmetro inválido: <PARAM_NAME>.

Indica que um parâmetro incompatível foi passado para a função.

Só pode ser chamado de dentro de um aplicativo.

Indica que a função foi chamada de fora de um aplicativo.

O comprimento da carga excede o limite de 9.000 caracteres.

Indica que a chamada para a função excede o limite de caracteres.

O número de eventos excede o limite de 100.

Indica que o número máximo de eventos faturáveis foi atingido para uma única chamada. A classe de evento personalizada especificada não é usada nesta determinação.

Muitas chamadas. No máximo uma chamada é permitida a cada janela de 10 milissegundos.

Indica que um aplicativo fez muitas chamadas para esta função do sistema dentro de um período específico.

Notas de uso

Essa função do sistema só pode ser chamada de dentro de um procedimento armazenado no script de configuração de um aplicativo criado usando o Snowflake Native App Framework.

Exemplos

Consulte Exemplos de eventos faturáveis.

Linguagem: Português