Ejecución de consultas SQL con el cliente de consulta de base de datos

Para ejecutar consultas SQL con el cliente de consulta de base de datos, realice los pasos siguientes:

1. Inicie el cliente de consulta de base de datos utilizando el siguiente URL:

   https://<hostname:port>/smcfs/yfshttpdbi/sterlingdbqueryclient.jsp

2. Especifique el ID de usuario y la Contraseña. La autenticación de usuario es válida hasta que caduque la sesión actual o hasta que se cierre la sesión actual. Si la sesión de navegador actual caduca, puede especificar sus credenciales de inicio de sesión y ejecutar consultas en la misma página.
3. Escriba una consulta SQL en Entrar consulta SQLy pulse Ejecutar consulta.

   En el campo Número de filas , especifique el número de filas que se mostrarán por página. De forma predeterminada, el valor se establece en 100. Si especifica un valor mayor, la paginación se habilita automáticamente. Puede especificar un valor máximo de 10000 filas que se visualizarán por página.

   • Ordene el resultado de la consulta por columna siempre que se utilice DISTINCT con la cláusula SELECT .
   • DISTINCT le permite ejecutar la consulta siguiente:
     select distinct <organization_code> from yfs_item where 1=1;
     Nota: Para la consulta DISTINCT con la columna de clave primaria no seleccionada, la paginación no está soportada. De forma predeterminada, el valor se establece en 100. Sin embargo, si desea ver más registros, aumente el tamaño de página. Se puede visualizar un máximo de 10000 registros.
   • Las consultas que contienen funciones de agregación como las cláusulas UNION, INTERSECTo WITH no están soportadas por la paginación. Estas consultas se ejecutan en una modalidad no paginada. Sin embargo, si desea ver más registros, aumente el tamaño de página a un límite máximo de 10000 registros.

   Nota:

   • No puede consultar tablas que contengan datos confidenciales o irrelevantes o que no contengan datos empresariales.
   • No puede ejecutar consultas que modifiquen las tablas.
   Algunas consultas de ejemplo son las siguientes:

   
   select * from yfs_resource fetch first 10 rows only;
   select * from yfs_resource_permission fetch first 10 rows only;
   select * from yfs_user fetch first 10 rows only;

   • Consulte las tablas para ordenar el resultado por columna no primaria. Por ejemplo:

     select * from yfs_user order by loginid fetch first 10 rows only;

   • Crear uniones utilizando subconsultas. Por ejemplo:

     
     select u.user_key, ug.USERGROUP_KEY, u.loginid, ug. USERGROUP_NAME from (SELECT * FROM
     omdb.YFS_USER)  as u RIGHT OUTER JOIN (SELECT * FROM omdb.YFS_USER_GROUP) as ug ON
     u.USERGROUP_KEY = ug.USERGROUP_KEY fetch first 10 rows only;

   • Utilización de la consulta de alias de columna. Por ejemplo, select order_no as Docket from yfs_order_header;

   • Recuperar información de índice de tablas utilizando sentencias describe . Por ejemplo, describe table YFS_USER;. Esta consulta sólo devuelve los detalles básicos del esquema de tabla como, por ejemplo, el tipo de datos, nulo o no nulo, y no la información de índice. Sin embargo, puede ejecutar describe indexes for table YFS_USER para recuperar los detalles de índice de la tabla.

   • Consultar tablas del esquema SYSCAT. Puede consultar las tablas siguientes desde el esquema SYSCAT:
     • SCHEMATA
     • TABLES-Al consultar esta tabla, se recomienda añadir una cláusula WHERE con tabschema = 'OMDB'
     • VIEWS-Al consultar esta tabla, se recomienda añadir una cláusula WHERE con viewschema = 'OMDB'
     • COLUMNS-Al consultar esta tabla, se recomienda añadir una cláusula WHERE con tabschema = 'OMDB'
     • INDEXES-Al consultar esta tabla, se recomienda añadir una cláusula WHERE con tabschema = 'OMDB'
     • TABCONST-Al consultar esta tabla, se recomienda añadir una cláusula WHERE con tabschema = 'OMDB'

     De forma predeterminada, en modalidad no paginada sólo se visualizan los primeros 100 registros. Si desea visualizar más registros, en el cliente de consulta de base de datos, especifique el número total de registros que desea visualizar.

   Métodos alternativos para ejecutar consultas

   • Pulse Última ejecución de consultas para ver todas las consultas que ha ejecutado anteriormente. Se guardan las últimas 100 consultas ejecutadas anteriormente y se visualizan 10 consultas por página. Puede ejecutar una consulta desde la lista.
   • En el campo Buscar consultas , especifique términos adecuados como palabras clave de consulta o nombres de tabla para buscar la consulta y pulse Ejecutar consulta. Por ejemplo, los términos de búsqueda pueden ser YFS_USER, SELECT. De forma alternativa, puede desplazarse por la lista y pulsar Siguiente o Anterior para buscar la consulta.
   • Importar y ejecutar una consulta.
   Nota:

   • Si no finaliza una consulta con un punto y coma, se añade internamente.
   • De forma predeterminada, la paginación está habilitada. Si se produce un problema para determinadas consultas, la paginación se inhabilita automáticamente y el resultado de la consulta se visualiza en función del número de filas especificadas.
   • Si hay problemas de conectividad de base de datos momentáneos, la herramienta reintenta tres veces conectarse a la base de datos. Si no se ejecuta correctamente, se muestra un mensaje adecuado.
   • El tiempo de espera de consulta es de 2 minutos.
   Resultados:

   • Para garantizar un rendimiento óptimo en el entorno de producción, sólo se visualizan las primeras 100 filas para las consultas con columnas CLOB.
   • Para consultas SQL con columnas CLOB, se visualizan un máximo de 100 registros y se pueden exportar.
   • Las columnas BLOB se muestran en la salida como --BLOB Data-- en lugar de mostrar un valor de serie del objeto binario en la página de resultados.
   • La herramienta devuelve los códigos de error de SQL exactos para que los usuarios puedan entender lo que está mal con una consulta. Por ejemplo, cuando ejecuta select * from YFS_USER_DETAILS, la herramienta devuelve el siguiente mensaje de error:

     Excepción al ejecutar la consulta. Compruebe la sintaxis de consulta/registros de servidor.
     "OMDB.YFS_USER_DETAILS" es un nombre no definido. SQLCODE=-204, SQLSTATE=42704, DRIVER=3.69.49

4. Opcional: de forma predeterminada, el recuadro de selección Exportar números como texto (sólo para visualizar en Microsoft Excel) está seleccionado. Para exportar el resultado de la consulta al archivo CSV, desmarque el recuadro de selección y, a continuación, pulse Exportar. Los resultados de la consulta se exportan a un .csv. Por ejemplo, queryResult--2020-8-5-13-19-19.csv.

   En el archivo CSV, los números largos se muestran en el formato exponencial. Por ejemplo, 12345678901234567890 se representa como 1.23457E+19.

   Para exportar los resultados de la consulta a un archivo CSV de sólo lectura , seleccione el recuadro de selección Exportar números como texto (sólo para visualizar en Microsoft Excel) . Por ejemplo, queryResult--2020-8-5-13-19-19_view-only-on-ms-excel.csv.

   El archivo CSV sólo se puede abrir en Microsoft Excel. En el archivo CSV exportado, se añade un apóstrofo (') como prefijo para los números que tienen más de 11 dígitos para que los números enteros se muestren como texto en Microsoft Excel. Sin embargo, los números que tienen menos de 11 dígitos se muestran como enteros y no contienen apóstrofos. Para los números que contienen ceros iniciales, Microsoft Excel trunca los ceros y sólo muestra los números. Por ejemplo, "0001" se visualiza como "1".