Rappels¶

Rappels synchrones¶

Les rappels synchrones sont appelés dans le cadre de la commande SQL de déclenchement. Les rappels synchrones bloquent la commande SQL d’appel. Si le rappel renvoie une erreur, la commande renverra une erreur, et le message d’erreur du rappel sera renvoyé dans le cadre du message d’erreur SQL de la commande.

Les rappels synchrones s’exécutent dans un entrepôt, de sorte que la procédure appelante doit avoir un entrepôt de session défini.

Rappels asynchrones¶

Les rappels asynchrones s’exécutent en arrière-plan, une fois la commande SQL d’appel terminée. Les rappels asynchrones ne bloquent pas la commande SQL d’appel, et les erreurs dans les rappels asynchrones ne sont pas renvoyées par la commande d’appel.

Pour garantir qu’un rappel asynchrone dispose des informations les plus récentes, la signature du rappel ne fournit pas d’informations d’état ou de statut. Au lieu de cela, le rappel doit récupérer les informations les plus récentes en utilisant les commandes SQL appropriées, telles que SHOW CONFIGURATIONS ou SHOW SPECIFICATIONS. Consultez la description de chaque rappel asynchrone pour plus d’informations.

La valeur de retour des rappels asynchrones est ignorée.

Autorisations¶

Les procédures de rappel énumérées dans cette rubrique ne sont pas tenues d’être attribuées à un rôle d’application. La procédure peut être interne à l’application et n’a pas besoin d’être exécutée par le consommateur. Le Snowflake Native App Framework déclenche le rappel.

Rappels de spécification ou de connexion¶

after_specification_change et after_server_connection_change sont tous deux exécutés lorsqu’une spécification est approuvée ou rejetée. Les différences entre les deux rappels sont les suivantes :

• after_specification_change fait partie du cadre de la spécification d’application. Il n’est déclenché que lorsque le consommateur approuve ou rejette une demande de spécification.

• after_server_connection_change fait partie du cadre de la communication inter-applications. Il est déclenché par toute opération ayant un impact direct ou indirect sur l’état de connexion de la spécification d’application, notamment :

  • Approbation d’une spécification

  • Refus d’une spécification approuvée

  • Suppression d’une spécification approuvée

  • Suppression de l’application du serveur

Utilisez after_server_connection_change lorsque votre application doit répondre à des changements dans la connexion elle-même, comme une connexion établie ou perdue, ou la suppression de l’application serveur. Ce rappel offre un meilleur suivi des connexions, car il couvre un éventail d’événements plus large que l’approbation des spécifications uniquement.

Utilisez after_specification_change lorsque votre application ne doit répondre qu’à l’approbation ou au refus d’une demande de spécification, ou lors du traitement de types de spécifications d’application autres que CONNECTION.

Rappels de configuration¶

Ces rappels sont déclenchés lorsqu’une configuration change.

• validate_configuration_change

• before_configuration_change

• after_configuration_change

validate_configuration_change(configuration_name, configuration_value)

{
  "type": "SUCCESS | ERROR",
  "payload":{
      "error_message": "Error message indicating the validation failure"
  }
}

before_configuration_change(configuration_name, configuration_value)

after_configuration_change(configuration_name)

session.sql(f"""
  SHOW CONFIGURATIONS ->>
      SELECT "status", "value"
      FROM $1
      WHERE "name" = '{configuration_name}';
  """);

Rappels de connexion¶

Ces rappels sont déclenchés lorsque l’état d’une connexion change.

• after_server_connection_change

• after_client_connection_change

• after_server_version_change

after_server_connection_change(server_name)

session.sql(f"""
  SHOW SPECIFICATIONS ->>
  SELECT "status"
  FROM $1
  WHERE PARSE_JSON("definition"):"SERVER_APPLICATION"::STRING = '{server_name}';
  """);

after_client_connection_change(client_name)

session.sql(f"""
  SHOW GRANTS TO APPLICATION {client_name} ->>
  SELECT "name"
  FROM $1
  WHERE "granted_on" = 'APPLICATION_ROLE'
      AND STARTSWITH("name", CURRENT_DATABASE())
  """);

after_server_version_change(server_name)

session.sql(f"""
  SHOW APPLICATIONS ->>
  SELECT "version", "patch"
  FROM $1
  WHERE "name" = {server_name}
  """);

Rappels de spécification¶

Le rappel est déclenché lorsqu’une spécification de tout type présente un changement d’état.

• after_specification_change

after_specification_change(spec_name)

session.sql(f"""
  SHOW SPECIFICATIONS ->>
      SELECT "status"
      FROM $1
      WHERE "name" = '{spec_name}';
  """);