Remarques :

Ce tutoriel nécessite un accès à Oracle Cloud. Pour vous inscrire à un compte gratuit, reportez-vous à Introduction au niveau gratuit d'Oracle Cloud Infrastructure.
Il utilise des exemples de valeur pour les informations d'identification Oracle Cloud Infrastructure, la location et les compartiments. A la fin de votre atelier, remplacez ces valeurs par celles propres à votre environnement cloud.

Activer la fonctionnalité de type de données étendu pour les bases de données Oracle

Introduction

Oracle Database 12c a introduit le paramètre MAX_STRING_SIZE qui contrôle la taille maximale des types de données VARCHAR2, NVARCHAR2 et RAW. La définition du paramètre MAX_STRING_SIZE sur EXTENDED active la taille du type de données sur une limite de 32767 octets. Lors de la définition de MAX_STRING_SIZE sur la valeur EXTENDED, le paramètre d'initialisation COMPATIBLE de la base de données doit être 12.0.0.0 ou une version supérieure.

Ce tutoriel décrit en détail les tâches permettant d'activer Oracle Database pour tirer parti des nouveaux types de données étendus nécessitant des actions de mise à niveau spécifiques.

Objectifs

Exploitez les types de données VARCHAR2, NVARCHAR2 et RAW pour atteindre la limite de 32767 octets.

Prérequis

La version de la base de données doit être Oracle 12.2 OU supérieure.

Tâche 1 : définition du type de données étendu sur une base de données non Conteneur

Exécutez la commande suivante .

SQL> SHOW PARAMETER MAX_STRING_

| NAME            | TYPE   | VALUE    |
| --------------- | ------ | -------- |
| max_string_size | string | STANDARD |

Démarrez la base de données en mode de mise à niveau.

SQL> SHUTDOWN IMMEDIATE;

Database closed.
Database dismounted.
ORACLE instance shut down.

SQL>STARTUP UPGRADE

ORACLE instance started.

Total System Global Area   1.4663E+10 bytes
Fixed Size                 15697000 bytes
Variable Size              1.1878E+10 bytes
Database Buffers           2717908992 bytes
Redo Buffers               51404800 bytes

Database mounted.
Database opened.

Remplacez la valeur MAX_STRING_SIZE par EXTENDED.

SQL>  alter system set MAX_STRING_SIZE='EXTENDED' SCOPE=BOTH;

System altered.

SQL> show parameter MAX_STRING_SIZE

| NAME            | TYPE   | VALUE    |
| --------------- | ------ | -------- |
| max_string_size | string | EXTENDED |

Exécutez le script utl32k.sql : @?/rdbms/admin/utl32k.sql.

SQL> @?/rdbms/admin/utl32k.sql

Session altered.

DOC>#######################################################################
DOC>#######################################################################
DOC> The following statement will cause an "ORA-01722: invalid number"
DOC> error if the database has not been opened for UPGRADE.
DOC>
DOC> Perform a "SHUTDOWN ABORT" and
DOC> restart using UPGRADE.
DOC>#######################################################################
DOC>#######################################################################
DOC>#

no rows selected

DOC>#######################################################################
DOC>#######################################################################
DOC> The following statement will cause an "ORA-01722: invalid number"
DOC> error if the database does not have compatible >= 12.0.0
DOC>
DOC> Set compatible >= 12.0.0 and retry.
DOC>#######################################################################
DOC>#######################################################################
DOC>#

PL/SQL procedure successfully completed.

Session altered.

1524 rows updated.

Commit complete.

System altered.

PL/SQL procedure successfully completed.

Commit complete.

System altered.

Session altered.

Session altered.

Table created.

Table created.

Table created.

Table truncated.

0 rows created.

PL/SQL procedure successfully completed.

no rows selected

DOC>#######################################################################
DOC>#######################################################################
DOC> The following statement will cause an "ORA-01722: invalid number"
DOC> error if we encountered an error while modifying a column to
DOC> account for data type length change as a result of enabling or
DOC> disabling 32k types.
DOC>
DOC> Contact Oracle support for assistance.
DOC>#######################################################################
DOC>#######################################################################
DOC>#

PL/SQL procedure successfully completed.

PL/SQL procedure successfully completed.

Commit complete.

Relancez la base de données.

shutdown immediate;
startup

SQL> show parameter max_string

| NAME            | TYPE   | VALUE    |
| --------------- | ------ | -------- |
| max_string_size | string | EXTENDED |

Tâche 2 : définition du type de données étendu sur une base de données Conteneur (CDB$ROOT)

Exécutez les commandes suivantes .

[oracle@vm4 ~]$ sqlplus "/ as sysdba"

SQL*Plus: Release 12.2.0.1.0 Production on Thu Sep 7 13:26:41 2023

Copyright (c) 1982, 2016, Oracle.  All rights reserved.

Connected to:
Oracle Database 12c EE Extreme Perf Release 12.2.0.1.0 - 64bit Production

SQL> SHOW PARAMETER MAX_STRING_

| NAME            | TYPE   | VALUE    |
| --------------- | ------ | -------- |
| max_string_size | string | STANDARD |

SQL> show pdbs;

| CON_ID | CON_NAME    | OPEN MODE  | RESTRICTED |
| ------ | ----------- | ---------- | ---------- |
| 2      | PDB$SEED    | READ ONLY  | NO         |
| 3      | RATPRD_PDB1 | READ WRITE | NO         |

[oracle@vm4 ~]$ cd $ORACLE_HOME/rdbms/admin
[oracle@vm4 admin]$ pwd
/u01/app/oracle/product/12.2.0.1/dbhome_1/rdbms/admin
[oracle@vm4 ~]$  mkdir -p /home/oracle/mydir/utl32k_cdb_pdbs_output
[oracle@vm4 ~]$ sqlplus "/ as sysdba"

SQL*Plus: Release 12.2.0.1.0 Production on Thu Sep 7 13:30:18 2023

Copyright (c) 1982, 2016, Oracle.  All rights reserved.

Connected to:
Oracle Database 12c EE Extreme Perf Release 12.2.0.1.0 - 64bit Production

SQL> ALTER SESSION SET CONTAINER=CDB$ROOT;

Session altered.

Remplacez la valeur MAX_STRING_SIZE par EXTENDED.

SQL> ALTER SYSTEM SET MAX_STRING_SIZE=extended SCOPE=SPFILE;

System altered.

Démarrez la base de données en mode de mise à niveau.

SQL> shutdown;

Database closed.
Database dismounted.
ORACLE instance shut down.

SQL> startup upgrade;

ORACLE instance started.

Total System Global Area 3.2749E+10 bytes
Fixed Size                 12351112 bytes
Variable Size            4160751992 bytes
Database Buffers         2.8387E+10 bytes
Redo Buffers              188973056 bytes

Database mounted.
Database opened.

SQL> exit

Exécutez le script catcon.pl.

Remarque : utilisez le script catcon.pl pour exécuter le script rdbms/admin/utl32k.sql à la racine et dans toutes les bases de données pluggables de la base de données Conteneur afin d'augmenter la taille maximale des colonnes VARCHAR2, NVARCHAR2 et RAW. L'option -force_pdb_mode 'UPGRADE' permet de s'assurer que toutes les bases de données pluggables, y compris les clones racine d'application, sont ouvertes en mode de migration. Entrez le mot de passe SYS à l'invite.

[oracle@vm4 ~]$ $ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u SYS --force_pdb_mode 'UPGRADE' -d $ORACLE_HOME/rdbms/admin -l '/home/oracle/mydir/utl32k_cdb_pdbs_output' -b utl32k_cdb_pdbs_output utl32k.sql
catcon: ALL catcon-related output will be written to [/home/oracle/mydir/utl32k_cdb_pdbs_output/utl32k_cdb_pdbs_output_catcon_88242.lst]
catcon: See [/home/oracle/mydir/utl32k_cdb_pdbs_output/utl32k_cdb_pdbs_output*.log] files for output generated by scripts
catcon: See [/home/oracle/mydir/utl32k_cdb_pdbs_output/utl32k_cdb_pdbs_output_*.lst] files for spool files, if any
Enter Password:    -> enter sys password
catcon.pl: completed successfully
[oracle@vm4 ~]$ sqlplus "/ as sysdba"

SQL*Plus: Release 12.2.0.1.0 Production on Thu Sep 7 13:48:56 2023

Copyright (c) 1982, 2016, Oracle.  All rights reserved.

Connected to:
Oracle Database 12c EE Extreme Perf Release 12.2.0.1.0 - 64bit Production

SQL> startup;

ORA-01081: cannot start already-running ORACLE - shut it down first

SQL> shut immediate;

Database closed.
Database dismounted.
ORACLE instance shut down.

SQL> startup;

ORACLE instance started.

Total System Global Area 3.2749E+10 bytes
Fixed Size                 12351112 bytes
Variable Size            4160751992 bytes
Database Buffers         2.8387E+10 bytes
Redo Buffers              188973056 bytes

Database mounted.
Database opened.

SQL> show parameter max_string_size;

| NAME            | TYPE   | VALUE    |
| --------------- | ------ | -------- |
| max_string_size | string | EXTENDED |

Tâche 3 : définition du type de données étendu sur la base pluggable

Exécutez les commandes suivantes pour modifier la base de données.

SQL> alter session set container = RATPRD_PDB1;

Session altered.

SQL> show pdbs

| CON_ID | CON_NAME    | OPEN MODE  | RESTRICTED |
| ------ | ----------- | ---------- | ---------- |
| 3      | RATPRD_PDB1 | READ WRITE | NO         |

SQL> ALTER PLUGGABLE DATABASE RATPRD_PDB1 CLOSE IMMEDIATE;

Pluggable database altered.

SQL>  show pdbs

| CON_ID | CON_NAME    | OPEN MODE | RESTRICTED |
| ------ | ----------- | --------- | ---------- |
| 3      | RATPRD_PDB1 | MOUNTED   |

Ouvrez la base de données pluggable RATPRD_PDB1 en mode de mise à niveau, requis pour modifier le paramètre max_string_size.

SQL> ALTER PLUGGABLE DATABASE RATPRD_PDB1 OPEN UPGRADE;

$
Pluggable database altered.

SQL>  show pdbs;

| CON_ID | CON_NAME    | OPEN MODE | RESTRICTED |
| ------ | ----------- | --------- | ---------- |
| 3      | RATPRD_PDB1 | MIGRATE   | YES        |

Exécutez utl32k.sql pour modifier la taille maximale des colonnes VARCHAR2,NVARCHAR2 et RAW sur la base pluggable RATPRD_PDB1.

SQL> @$ORACLE_HOME/rdbms/admin/utl32k.sql;

Session altered.

DOC>#######################################################################
DOC>#######################################################################
DOC> The following statement will cause an "ORA-01722: invalid number"
DOC> error if the database has not been opened for UPGRADE.
DOC>
DOC> Perform a "SHUTDOWN ABORT" and
DOC> restart using UPGRADE.
DOC>#######################################################################
DOC>#######################################################################
DOC>#

no rows selected

DOC>#######################################################################
DOC>#######################################################################
DOC> The following statement will cause an "ORA-01722: invalid number"
DOC> error if the database does not have compatible >= 12.0.0
DOC>
DOC> Set compatible >= 12.0.0 and retry.
DOC>#######################################################################
DOC>#######################################################################
DOC>#

PL/SQL procedure successfully completed.

Session altered.

0 rows updated.

Commit complete.

System altered.

PL/SQL procedure successfully completed.

Commit complete.

System altered.

Session altered.

Session altered.

Table created.

Table created.

Table created.

Table truncated.

0 rows created.

PL/SQL procedure successfully completed.

STARTTIME :

09/07/2023 14:32:06.790646000

PL/SQL procedure successfully completed.

No errors.

PL/SQL procedure successfully completed.

Session altered.

Session altered.

0 rows created.

no rows selected

no rows selected

DOC>#######################################################################
DOC>#######################################################################
DOC> The following statement will cause an "ORA-01722: invalid number"
DOC> error if we encountered an error while modifying a column to
DOC> account for data type length change as a result of enabling or
DOC> disabling 32k types.
DOC>
DOC> Contact Oracle support for assistance.
DOC>#######################################################################
DOC>#######################################################################
DOC>#

PL/SQL procedure successfully completed.

PL/SQL procedure successfully completed.

Commit complete.

Package altered.

Package altered.

SQL> show pdbs;

| CON_ID | CON_NAME    | OPEN MODE | RESTRICTED |
| ------ | ----------- | --------- | ---------- |
| 3      | RATPRD_PDB1 | MIGRATE   | YES        |

SQL> ALTER PLUGGABLE DATABASE RATPRD_PDB1 CLOSE IMMEDIATE;

Pluggable database altered.

Vérifiez que la valeur du paramètre max_string_size est remplacée par EXTENDED.

SQL> ALTER PLUGGABLE DATABASE RATPRD_PDB1 open ;

Pluggable database altered.

SQL>  show pdbs;

| CON_ID | CON_NAME    | OPEN MODE  | RESTRICTED |
| ------ | ----------- | ---------- | ---------- |
| 3      | RATPRD_PDB1 | READ WRITE | NO         |

SQL> show parameter max_string_size;

| NAME            | TYPE   | VALUE    |
| --------------- | ------ | -------- |
| max_string_size | string | EXTENDED |

Référence Oracle Database : MAX_STRING_SIZE

Remerciements

Auteur - Hakim Ahamad (architecte cloud principal)

Ressources de formation supplémentaires

Explorez d'autres ateliers sur docs.oracle.com/learn ou accédez à davantage de contenu de formation gratuit sur le canal Oracle Learning YouTube. En outre, accédez à education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour consulter la documentation produit, consultez Oracle Help Center.

Informations relatives au titre et au copyright

Enable the Extended Data Type Capability for Oracle databases

F87592-01

October 2023