ALTER SESSION

Définit les paramètres qui modifient le comportement de la session en cours.

Voir aussi :

SHOW PARAMETERS

Syntaxe

ALTER SESSION SET sessionParams

ALTER SESSION UNSET <param_name> [ , <param_name> , ... ]

Où :

sessionParams ::=
  ABORT_DETACHED_QUERY = TRUE | FALSE
  ACTIVE_PYTHON_PROFILER = 'LINE' | 'MEMORY'
  AUTOCOMMIT = TRUE | FALSE
  BINARY_INPUT_FORMAT = <string>
  BINARY_OUTPUT_FORMAT = <string>
  DATE_INPUT_FORMAT = <string>
  DATE_OUTPUT_FORMAT = <string>
  ERROR_ON_NONDETERMINISTIC_MERGE = TRUE | FALSE
  ERROR_ON_NONDETERMINISTIC_UPDATE = TRUE | FALSE
  GEOGRAPHY_OUTPUT_FORMAT = 'GeoJSON' | 'WKT' | 'WKB' | 'EWKT' | 'EWKB'
  HYBRID_TABLE_LOCK_TIMEOUT = <num>
  JSON_INDENT = <num>
  LOG_LEVEL = <string>
  LOCK_TIMEOUT = <num>
  PYTHON_PROFILER_TARGET_STAGE = <string>
  PYTHON_PROFILER_MODULES = <string>
  QUERY_TAG = <string>
  ROWS_PER_RESULTSET = <num>
  S3_STAGE_VPCE_DNS_NAME = <string>
  SEARCH_PATH = <string>
  SIMULATED_DATA_SHARING_CONSUMER = <string>
  STATEMENT_TIMEOUT_IN_SECONDS = <num>
  STRICT_JSON_OUTPUT = TRUE | FALSE
  TIMESTAMP_DAY_IS_ALWAYS_24H = TRUE | FALSE
  TIMESTAMP_INPUT_FORMAT = <string>
  TIMESTAMP_LTZ_OUTPUT_FORMAT = <string>
  TIMESTAMP_NTZ_OUTPUT_FORMAT = <string>
  TIMESTAMP_OUTPUT_FORMAT = <string>
  TIMESTAMP_TYPE_MAPPING = <string>
  TIMESTAMP_TZ_OUTPUT_FORMAT = <string>
  TIMEZONE = <string>
  TIME_INPUT_FORMAT = <string>
  TIME_OUTPUT_FORMAT = <string>
  TRACE_LEVEL = <string>
  TRANSACTION_DEFAULT_ISOLATION_LEVEL = <string>
  TWO_DIGIT_CENTURY_START = <num>
  UNSUPPORTED_DDL_ACTION = <string>
  USE_CACHED_RESULT = TRUE | FALSE
  WEEK_OF_YEAR_POLICY = <num>
  WEEK_START = <num>

Note

Pour plus de lisibilité, la liste complète des paramètres de session pouvant être définis n’est pas incluse ici. Pour une liste complète de tous les paramètres de session, avec leurs descriptions, ainsi que les paramètres de compte et d’objet, voir Paramètres.

Paramètres

SET ...

Spécifie un (ou plusieurs) paramètre(s) à définir pour la session (séparés par des espaces, des virgules ou de nouvelles lignes).

Pour obtenir la description de chacun des paramètres que vous pouvez définir pour une session, voir Paramètres.

UNSET ...

Spécifie un (ou plusieurs) paramètre(s) à désactiver pour la session, ce qui les réinitialise aux valeurs par défaut.

Vous pouvez réinitialiser plusieurs paramètres avec une seule instruction ALTER ; cependant, chaque propriété doit être séparée par une virgule. Lors de la réinitialisation d’une propriété, spécifiez seulement le nom ; si vous spécifiez une valeur pour la propriété, vous obtiendrez une erreur.

Notes sur l’utilisation

  • Les paramètres sont saisis. Les types pris en charge sont BOOLEAN, NUMBER et STRING.

  • Pour afficher les valeurs actuelles des paramètres de la session, utilisez SHOW PARAMETERS.

Exemples

Définir le délai de verrouillage des instructions exécutées au cours de la session sur 1 heure (3 600 secondes) :

ALTER SESSION SET LOCK_TIMEOUT = 3600;

Rétablir le délai de verrouillage par défaut des instructions exécutées au cours de la session :

ALTER SESSION UNSET LOCK_TIMEOUT;