콜백¶

validate_configuration_change¶

이 콜백은 동기 콜백입니다.

이 콜백은 ALTER APPLICATION SET CONFIGURATION VALUE 명령의 일부로 호출됩니다. 이 콜백을 통해 앱은 서버 앱에서 제공한 값에 대해 추가 사용자 지정 유효성 검사를 수행할 수 있습니다. 구문 오류와 같이 콜백이 실패하거나 콜백이 오류를 반환하는 경우 set 명령이 실패하고 새 값이 설정되지 않습니다.

validate_configuration_change(configuration_name, configuration_value)

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

before_configuration_change¶

이 콜백은 동기 콜백입니다. 이 콜백은 ALTER APPLICATION SET CONFIGURATION VALUE 및 ALTER APPLICATION UNSET CONFIGURATION 명령의 일부로 호출됩니다. 이 콜백을 통해 앱은 설정된 구성 값에 따라 추가 작업을 수행할 수 있습니다. 콜백에 전달된 값은 ALTER APPLICATION UNSET CONFIGURATION 명령에 대해 null입니다.

before_configuration_change(configuration_name, configuration_value)

after_configuration_change¶

이 콜백은 비동기 콜백입니다. 이 콜백은 ALTER APPLICATION SET CONFIGURATION VALUE 및 ALTER APPLICATION UNSET CONFIGURATION 명령이 완료된 이후에 호출됩니다. 이 콜백을 사용하면 서버 앱에서 값이 제공될 때 클라이언트 앱에 알림이 제공됩니다.

after_configuration_change(configuration_name)

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

after_server_connection_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¶

이 콜백은 비동기 콜백입니다. 이 콜백은 다음을 포함하여 애플리케이션 사양의 연결 상태에 직접 또는 간접적으로 영향을 미치는 모든 작업에 의해 트리거됩니다.

• 사양 승인하기

• 승인된 사양 거부하기

• 승인된 사양 삭제하기

• 클라이언트 앱 삭제하기

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¶

이 콜백은 비동기 콜백입니다. 이 콜백은 서버 앱의 버전 또는 패치 번호가 변경된 이후에 호출됩니다. 이를 통해 클라이언트 앱이 업그레이드 또는 다운그레이드에 대응할 수 있습니다.

after_server_version_change(server_name)

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

after_specification_change¶

이 콜백은 비동기 콜백입니다. 이 콜백은 ALTER APPLICATION APPROVE SPECIFICATION 또는 ALTER APPLICATION DECLINE SPECIFICATION 명령이 완료된 이후에 호출됩니다. 이 콜백을 사용하면 사양 상태가 변경될 때 앱에 알림을 보낼 수 있습니다.

이 콜백은 specification_action 콜백의 기능을 대체합니다. 매니페스트 파일에는 after_specification_change 또는 specification_action 중 하나만 지정할 수 있습니다. specification_action 콜백에 대한 자세한 내용은 앱 사양과 함께 콜백 함수 사용 섹션을 참조하세요.

after_specification_change(spec_name)

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