Bteq

Teradata















1 Introducción 3


2 Comandos Básicos 4

2.1 .LOGON 4
2.2 .QUIT 4
2.3 .GOTO 5
2.4 .LABEL 5
2.5 .REMARK 5
2.6 .IF ... THEN ... 5
2.6.1 Ejemplo 1: 7
2.6.2 Ejemplo 2: 8

Ejemplo BTEQ. ECHOREQ ON 9


Ejemplo BTEQ. ECHOREQ OFF 12










Introducción




BTEQ (Basic Teradata Query), en unprograma basado en comandos para el acceso a Bases de Datos Teradata.

Una sesión BTEQ permite un acceso rápido y sencillo a Bases de Datos de Teradata, utilizando comandos SQL Teradata para el acceso a los datos.

BTEQ puede operar de dos diferentes formas:

1. Modo Interactivo. Inicia una sesión de BTEQ para operar directamente sobre la Base de Datos

2.Modo Batch. Preparando Scripts o macros, que se pueden lanzar posteriormente sobre Unix.

En este manual vamos a centrarnos en el segundo punto, para poder realizar consultas, tanto periódicas como puntuales, que requieran mucho tiempo de proceso o gran capacidad de spool. Permitiendo liberar la ventana de usuarios de procesos “cojo-queries”.

La herramienta Queryman, aunque esmás sencilla y con un interface más agradable, en una caída de la máquina o de la red, perderá la conexión con Teradata. Una sesión BTEQ, en estos casos, continuará ejecutándose.

La ejecución de una script BTEQ se realiza con la siguiente estructura:

nohup bteq < script_bteq > salida_bteq &







Comandos Básicos





1 .LOGONRealiza el Logon a la Base de Datos Teradata. La sintaxis del comando es:

.LOGON Usuario, Password



Salida:
BTEQ 05.03.00.00 Wed May 24 17:35:32 2000
+---------+---------+---------+---------+---------+---------+---------+----
.LOGON t145931r,


*** Logon successfully completed.
*** Transaction Semantics are BTET.
*** CharacterSet Code is 69.


*** Total elapsed time was 1 second.
+---------+---------+---------+---------+---------+---------+---------+----



2 .QUIT



Realiza el Logoff de la base de datos finalizando la BTEQ. La sintaxis del comando es:

.QUIT [ n / ERRORCODE / ACTIVITYCO]

|Si se especifica... ||
| N |Smallint que indica el error producido. Si el valor de retorno del .QUIT es 0 entonces es que |
| |la ejecución de la BTEQ no ha tenido ningún error. Los valores |
| |0 al 10 son propios de la BTEQ.|
|ERRORCODE |Captura el valor de retorno de la ultima query ejecutada. Si ERRORCODE |
| |es igual a 0 entonces la query se ha ejecutado correctamente. |
|ACTIVITYCO |Captura el número de registros tratados en la ultima query. || |Retorna un código de error producido en la BTEQ. El rango de valores |
| |retornados varia de 0 a 10. Siendo el valor 0 que no se ha producido |
| |ningún error. |


Salida:+---------+---------+---------+---------+---------+---------+---------+----
.quit ERRORCODE
*** You are now logged off from the DBC.
*** Exiting BTEQ...
*** RC (return code) = 0

3 .GOTO




El comando .GOTO ignora todas las sentencias BTEQ / SQL hasta la etiqueta especificada. La sintaxis del comando es:

.GOTO nombre_etiqueta...