Extensions Image, Audio et Vidéo Administration et programmation

DB2Audio


Image Audio Vidéo
  X  

Stocke le contenu d'une séquence audio dans une table de base de données. La source audio peut se trouver dans une mémoire tampon client, un fichier client ou dans un fichier du serveur. L'objet audio peut être stocké dans la table de la base de données en tant qu'objet BLOB ou dans un fichier du serveur (référencé par la table de la base de données). Le format de la source audio peut être pris en charge ou non. Dans le premier cas, l'extension DB2Audio identifie ses attributs pour le stockage. Dans le second cas, vous devez indiquer ses attributs dans la fonction UDF.

Fichier d'inclusion

dmbaudio.h

Syntaxe

Stockage du contenu à partir d'une mémoire tampon ou d'un fichier client

>>-DB2Audio--(--nombd--,--contenu--,--format--,----------------->
 
>----fichier_cible--,--commentaire--)--------------------------><
 

Syntaxe

Stockage du contenu à partir d'un fichier serveur

>>-DB2Audio--(--nombd--,--fichier_source--,--format--,--typestoc--,-->
 
>---commentaire--)---------------------------------------------><
 

Syntaxe

Stockage du contenu avec des attributs définis par l'utilisateur à partir d'une mémoire tampon ou d'un fichier client

>>-DB2Audio--(--nombd--,--contenu--,--fichier_cible--,---------->
 
>----commentaire--,--attrs--)----------------------------------><
 

Syntaxe

Stockage du contenu avec des attributs définis par l'utilisateur à partir d'un fichier serveur

>>-DB2Audio--(--nombd--,--fichier_source--,--typestoc--,--commentaire--,-->
 
>---attrs--)---------------------------------------------------><
 

Paramètres (type de données)

nombd (VARCHAR(18))
Nom de la base de données à laquelle vous êtes connecté, indiqué par le registre spécial CURRENT SERVER.

contenu (BLOB(2G) AS LOCATOR)
Variable SQL représentant le contenu de l'objet audio. Cette variable peut être de type BLOB, BLOB_FILE ou BLOB_LOCATOR. DB2 considère le type de données du contenu comme le BLOB-LOCATOR et transfère le releveur de coordonnées LOB à la fonction UDF DB2Audio.

format (VARCHAR(8))
Format de l'objet audio source. Vous pouvez indiquer une valeur nulle ou une chaîne de caractères vide. Dans ce cas, l'extension audio tente de déterminer le format source automatiquement. L'objet audio est stocké dans le même format que l'objet source correspondant. Pour connaître les formats audio admis, reportez-vous au Tableau 4.

fichier_cible(LONG VARCHAR)
Nom du fichier du serveur cible (dans le cas d'un stockage dans un fichier du serveur), valeur nulle ou chaîne de caractères vide (dans le cas d'un stockage dans une table de base de données en tant qu'objet BLOB). Le nom du fichier cible peut être qualifié complet. S'il n'est pas qualifié, le fichier est localisé à l'aide des variables d'environnement DB2AUDIOSTORE et DB2MMSTORE sur le serveur.

fichier_source (LONG VARCHAR)
Nom du fichier du serveur source. Ce nom peut être qualifié complet ou non qualifié, mais ne doit pas être une valeur nulle ou une chaîne de caractères vide. Si le nom du fichier n'est pas qualifié, ce dernier est localisé à l'aide des variables d'environnement DB2AUDIOPATH et DB2MMPATH sur le serveur.

typestoc (INTEGER)
Valeur indiquant où l'objet audio est stocké. La constante MMDB_STORAGE_TYPE_INTERNAL (value=1) indique que l'objet audio est stocké dans la base de données en tant qu'objet BLOB ; la constante MMDB_STORAGE_TYPE_EXTERNAL (value=0) indique que le contenu de l'objet audio est stocké dans un fichier du serveur (la base de données contient un pointeur sur ce fichier).

commentaire (LONG VARCHAR)

Commentaire à stocker avec l'objet audio.

attrs (LONG VARCHAR FOR BIT DATA)
Attributs de l'objet audio.

Codes retour (type de données)

Descripteur de l'objet audio (DB2AUDIO)

Exemples

Insertion d'un enregistrement comprenant une séquence audio pour Anne Dupont dans la table Employés. La source audio se trouve dans une mémoire tampon client. Stockage de la séquence audio dans la table en tant qu'objet BLOB :

EXEC SQL BEGIN DECLARE SECTION;
     SQL TYPE IS BLOB (5M) aud_seg;
  EXEC SQL END DECLARE SECTION;
 
EXEC SQL INSERT INTO EMPLOYEE VALUES(
        '128557',
      'Anne Dupont',
               DB2AUDIO(
          CURRENT SERVER,
         :aud_seg,
          'WAVE',
                 CAST(NULL as LONG VARCHAR),
         
         'Voix d''Anne'));

Insertion d'un enregistrement comprenant une séquence audio pour Robert Durand dans la table Employés. La source audio se trouve dans un fichier du serveur. L'enregistrement de la table Employés pointe sur ce fichier.

EXEC SQL BEGIN DECLARE SECTION;
long hvStorageType;
  EXEC SQL END DECLARE SECTION;
 
hvStorageType = MMDB_STORAGE_TYPE_EXTERNAL;
 
EXEC SQL INSERT INTO EMPLOYEE VALUES(
      '384779',
      'Robert Durand',
               DB2AUDIO(
          CURRENT SERVER,
         '/Employés/sons/rdurand.wav',
         'WAV',
          :hvStorageType,
         'Voix de Robert'));

Insertion d'un enregistrement comprenant une séquence audio pour Anne Dupont dans la table Employés. Stockage de la séquence audio en tant qu'objet BLOB. La séquence audio source, qui se trouve dans un fichier du serveur, a un format défini par l'utilisateur, une fréquence d'échantillonnage de 44,1 KHz, et comporte deux canaux enregistrés.

EXEC SQL BEGIN DECLARE SECTION;
long hvStorageType;
         struct  {
        short len;
       char data[600];
}hvAudattr;
  EXEC SQL END DECLARE SECTION;
 
MMDBAudioAttrs          *paudiattr;
 
hvStorageType = MMDB_STORAGE_TYPE_INTERNAL;
 
paudioattr=(MMDBAudioAttrs *) hvAudattr.data;
strcpy(paudioAttr>cFormat,"cFormatA");
paudioAttr>ulSamplingRate=44100;
paudioAttr>usNumChannels=2;
hvAudattrs.len=sizeof(MMDBAudioAttrs);
 
EXEC SQL INSERT INTO EMPLOYEE VALUES(
        '128557',
      'Anne Dupont',
               DB2AUDIO(
          CURRENT SERVER,
          '/Employés/sons/adupont.aud',
          :hvStorageType,
               'Voix d"Anne',
               :hvAudattr)
       );


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]