USE (Comando)

Abre una tabla y sus archivos de índice asociados, o una vista SQL.

USE [[DatabaseName!]Table | SQLViewName | ?]
   [IN nWorkArea | cTableAlias]   [ONLINE]   [ADMIN]   [AGAIN]
   [NOREQUERY [nDataSessionNumber]]   [NODATA]   [INDEX IndexFileList | ?
   [ORDER [nIndexNumber | IDXFileName   | [TAG] TagName [OF CDXFileName]
      [ASCENDING | DESCENDING]]]]   [ALIAS cTableAlias]   [EXCLUSIVE]
   [SHARED]   [NOUPDATE]   [CONNSTRING cConnectString]

Parámetros

• [DatabaseName!]TableName
  Especifica el nombre de la tabla que se va a abrir. Puesto que los espacios en blanco son importantes en los nombres de archivo de Microsoft Windows 98 y posteriores, evite usar espacios adicionales en TableName. Si un nombre de tabla contiene espacios, escríbalo entre comillas (" " o ' ')

  Para abrir una tabla fuera de la base de datos actual, califique la tabla con el nombre de la base de datos, con un signo de exclamación (!) para separar el nombre de la base de datos del nombre de la tabla. Si no califica una tabla con un nombre de base de datos, Microsoft Visual FoxPro sólo podrá abrir las tablas de la base de datos actual. Si el nombre de la base de datos, el nombre de la tabla o ambos contienen espacios, escriba el nombre de la base de datos y el nombre de la tabla entre comillas (" " o ' ')

  **Nota   **Visual FoxPro no reconocerá correctamente un nombre de ruta de acceso si el nombre del disco o del directorio contiene un signo de exclamación (!).

• SQLViewName
  Especifica el nombre de una vista SQL de la base de datos actual que desea abrir. Las vistas de SQL se crean con CREATE SQL VIEW. SQLViewName también puede ser el nombre de una vista sin conexión creada con CREATEOFFLINE( ).

• ?
  Muestra el cuadro de diálogo Uso, que le permite elegir una tabla para abrirla.

• IN nWorkArea
  Especifica el área de trabajo en la que se abre la tabla. Puede cerrar una tabla de un área de trabajo determinada, ejecutando USE con la cláusula IN y el número del área de trabajo.

  La cláusula IN admite 0 como área de trabajo. Al incluir 0, se abrirá una tabla en el área de trabajo que tenga el número más bajo. Por ejemplo, si hay tablas abiertas en las áreas de trabajo de 1 a 10, el siguiente comando abrirá la tabla customer en el área de trabajo 11:

  USE customer IN 0
  

• IN cTableAlias
  Especifica que la tabla se abre en el área de trabajo de una tabla que está abierta actualmente. El alias de la tabla abierta se especifica con cTableAlias.

  Si omite nWorkArea y cTableAlias, la tabla se abrirá en el área de trabajo seleccionada actualmente.

• ONLINE
  Abre una vista sin conexión creada con CREATEOFFLINE( ). Especifique el nombre de la vista sin conexión en SQLViewName. Utilice TABLEUPDATE( ) para actualizar los datos en el servidor.

  Es necesario abrir la vista sin conexión de forma exclusiva. Incluya la cláusula EXCLUSIVE en USE o SET EXCLUSIVE en ON antes de abrir la vista sin conexión con USE.

• ADMIN
  Abre una vista sin conexión creada con CREATEOFFLINE( ), pero no actualiza los datos en el servidor con las modificaciones realizadas en la vista sin conexión. El hecho de abrir una vista sin conexión con la palabra clave ADMIN permite realizar cambios en la vista sin conexión sin actualizar los datos del servidor.

• AGAIN
  Para abrir una tabla de forma simultánea en varias áreas de trabajo, puede realizar alguna de las acciones siguientes:

  • Seleccionar otra área de trabajo y ejecutar USE con el nombre de la tabla y la cláusula AGAIN.
  • Ejecutar USE con el nombre de la tabla y la cláusula AGAIN, y especificar un área de trabajo distinta con la cláusula IN.

  Cuando vuelva a abrir una tabla en otra área de trabajo, la tabla de la nueva área de trabajo tomará los atributos de la tabla del área de trabajo original. Por ejemplo, si la tabla se abre para acceso de sólo lectura o exclusivo, y se vuelve a abrir en otra área de trabajo, la tabla se abrirá con el mismo tipo de acceso en la nueva área de trabajo.

  Los archivos de índice abiertos para la tabla original estarán disponibles para la tabla que vuelva a abrir si no abre ningún índice al abrir de nuevo la tabla. El orden de índice se establecerá en 0 en las áreas de trabajo donde vuelva a abrir la tabla.

  Puede abrir índices que no estuvieran abiertos en la tabla original. El orden de índice se establece en 0 para la tabla original.

  A una tabla abierta de nuevo se le asigna el alias predeterminado del área de trabajo. Puede incluir un alias cada vez que abra una tabla en varias áreas de trabajo, siempre y cuando los alias sean únicos.

  En Visual FoxPro para Windows, al volver a abrir una tabla en otra área de trabajo no se consume ningún controlador de archivo adicional.

• NOREQUERY [nDataSessionNumber]
  Especifica que los datos de una vista SQL remota no se vuelvan a descargar. NOREQUERY solamente está disponible para vistas SQL y se suele utilizar cuando se vuelve a abrir una vista SQL, incluyendo la cláusula AGAIN. Al incluir la cláusula NOREQUERY se mejora el rendimiento de grandes conjuntos de datos porque no es necesario volver a descargar los datos.

  nDataSessionNumber puede incluirse para especificar que los datos para una vista SQL remota de una sesión de datos determinada no se descarguen de nuevo. Si se omite nDataSessionNumber, los datos no se descargarán para la vista abierta en la sesión de datos actual.

  Para obtener información adicional acerca de la cláusula NOREQUERY, vea Crear vistas.

• NODATA
  Especifica que sólo se descargue la estructura de una vista SQL. Los datos de la vista SQL no se descargan. NODATA es el método más rápido de determinar la estructura de una vista SQL.

  Para obtener más información acerca de la cláusula NODATA, vea Crear vistas.

• INDEX IndexFileList
  Especifica un conjunto de índices que se deben abrir junto con la tabla. Si una tabla tiene un archivo de índice compuesto estructural, el archivo de índice se abrirá automáticamente con la tabla.

  IndexFileList puede contener cualquier combinación de nombres de archivos de índice .idx de una sola entrada y .cdx de entrada compuesta. No necesita incluir las extensiones de los nombres de los archivos de índice, a no ser que haya archivos .idx y .cdx con el mismo nombre en la lista de archivos.

  El archivo de índice cuyo nombre aparezca el primero en la lista de archivos de índice será el archivo de índice de control, y controlará cómo se tiene acceso y se muestran los registros de la tabla. Si el primer archivo de índice es un archivo de índice compuesto .cdx, se mostrarán los registros de la tabla y se tendrá acceso a ellos en el orden físico de los registros.

• INDEX ?
  Muestra el cuadro de diálogo Abrir con una lista de archivos de índice disponibles entre los que puede elegir.

• ORDER [nIndexNumber]
  Especifica una etiqueta de archivo de índice .cdx compuesto o un archivo .idx de índice de una sola entrada de control principal distinto del primer archivo de índice o de la primera etiqueta de índice especificados en IndexFileList.

  Los archivos de índice .idx se numeran primero en el orden en que aparecen en la lista de archivos de índice. Las etiquetas de los archivos de índice compuesto estructural (si existe alguno) se numeran entonces en el orden en que se crearon las etiquetas. Por último, las etiquetas de todos los archivos de índice compuesto independientes se numeran en el orden en que se crearon. También puede utilizar SET ORDER para especificar el archivo de índice o la etiqueta de control. Vea SET ORDER para obtener más información acerca de la numeración de archivos y etiquetas de índice.

  Si nIndexNumber es 0, los registros de la tabla se mostrarán y se tendrá acceso a ellos en el orden físico de los registros, y los registros permanecerán abiertos. La inclusión de ORDER 0 permitirá que todos los archivos de índice abiertos se actualicen mientras se presentan los registros ordenados por el número de registro. Incluir ORDER sin nIndexNumber es idéntico a incluir ORDER 0.

• ORDER [IDXFileName]
  Especifica un archivo de índice .idx de una sola entrada como archivo de índice de control principal.

• ORDER [TAG TagName] [OF CDXFileName]
  Especifica una etiqueta de control principal en un archivo de índice .cdx compuesto. El nombre de la etiqueta puede ser de un archivo de índice compuesto estructural o de cualquier archivo de índice compuesto que esté abierto. Si existen nombres de etiqueta idénticos en los archivos de índice compuesto abiertos, incluya OF CDXFileName y especifique el nombre del archivo de índice compuesto que contiene la etiqueta deseada.

• ASCENDING
  Especifica que se tiene acceso y se muestran los registros de la tabla en orden ascendente.

• DESCENDING
  Especifica que se tiene acceso y se muestran los registros de la tabla en orden descendente.

  La inclusión de ASCENDING o DESCENDING no cambia el archivo o la etiqueta de índice: solamente altera el orden en que se muestran y se tiene acceso a los registros.

• ALIAS cTableAlias
  Crea un alias para la tabla. Puede hacer referencia a una tabla por su alias en los comandos y funciones que requieren o admiten un alias.

  Cuando se abre una tabla, se le asigna automáticamente un alias, que es el nombre de la tabla si no se incluye ALIAS. Puede crear un alias nuevo o distinto para la tabla si incluye ALIAS. En Visual FoxPro, un alias puede contener hasta 254 letras, dígitos o signos de subrayado, y debe comenzar por una letra o un signo de subrayado. En las demás versiones de FoxPro, los alias pueden contener como máximo 10 letras, dígitos o signos de subrayado, y deben comenzar por una letra o un signo de subrayado.

  Se asigna automáticamente un alias predeterminado cuando abre una sola tabla de forma simultánea en varias áreas de trabajo con AGAIN y no se especifica un alias al abrir la tabla en cada área de trabajo.

  También se asigna un alias predeterminado cuando se produce un conflicto. Por ejemplo:

  CLOSE DATABASES
  OPEN DATABASE (HOME(2) + 'Data\testdata')
  ACTIVATE WINDOW View  && Open the Data Session Window
  USE customer ALIAS orders IN 1     && Alias is ORDERS
  USE orders IN 3     && Conflict; alias is C
  

• EXCLUSIVE
  Abre la tabla para uso exclusivo en una red. Para obtener más información acerca del uso exclusivo de tablas, vea SET EXCLUSIVE.

• SHARED
  Abre una tabla para uso compartido en una red. SHARED permite abrir una tabla para uso compartido, incluso cuando EXCLUSIVE está establecido en ON.

• NOUPDATE
  Impide realizar cambios en la tabla y en su estructura.

• CONNSTRING cConnectString
  Especifica una cadena de conexión para el origen de datos ODBC. Puede usar la cadena de conexión en lugar de incluir explícitamente el origen de datos ODBC, la identificación del usuario y la contraseña.

  Visual FoxPro pasa la cadena de conexión a la Vista remota especificada en SQLViewName, que a su vez utiliza esta cadena de conexión en lugar de las cadenas de conexión previamente definidas para conectar con el origen de datos especificado. Si se pasa una cadena vacía, "" , se muestra el cuadro de diálogo Origen de datos SQL, que permite al usuario seleccionar un origen de datos. Si especifica datos incompletos en la cadena de conexión, el origen de datos muestra un cuadro de diálogo de inicio de sesión para escribir los datos de inicio de sesión necesarios. Si omite el argumento opcional CONNSTRING cConnectionString, la vista remota utilizará la conexión predeterminada definida actualmente. Para obtener más información acerca de las cadenas de conexión de origen de datos, consulte la documentación del controlador ODBC.

Observaciones

Si se ejecuta USE sin un nombre de tabla y está abierto un archivo de tabla en el área de trabajo actual, la tabla se cerrará. También se cerrará la tabla cuando se abra otra tabla en la misma área de trabajo. No puede tener abierta más de una tabla a la vez en una misma área de trabajo.

Ejemplo

En el ejemplo siguiente se abren tres tablas en tres áreas de trabajo distintas. Se abre la ventana Sesión de datos para mostrar dónde están abiertas las tablas y para mostrar el alias para cada tabla.

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
ACTIVATE WINDOW View

USE customer IN 0  && Opens Customer table
USE employee IN 0  && Opens Employee table
USE products IN 0  && Opens Products table

Vea también

CREATE | CREATE SQL VIEW | CREATE TABLE - SQL | CREATEOFFLINE( ) | DBF( ) | INDEX | USED( ) | Crear vistas | SET EXCLUSIVE