Share via


RENAME CONNECTION (Comando)

Cambia el nombre de una conexión con nombre de la base de datos actual.

RENAME CONNECTION ConnectionName1 TO ConnectionName2

Parámetros

  • ConnectionName1
    Especifica la conexión cuyo nombre se va a cambiar.
  • ConnectionName2
    Especifica el nuevo nombre de la conexión.

Observaciones

La base de datos que contiene la conexión con nombre debe estar abierta de forma exclusiva y activa para poder cambiar el nombre de la conexión. Para abrir una base de datos para uso exclusivo, incluya EXCLUSIVE en OPEN DATABASE.

Ejemplo

El ejemplo siguiente supone que hay un origen de datos ODBC disponible llamado MyFoxSQLNT y que el Id. de usuario para el origen de datos es "sa". Se abre la base de datos testdata y se crea una conexión llamada Myconn1. Se usa DISPLAY CONNECTIONS para mostrar las conexiones con nombre de la base de datos.

Luego se usa RENAME CONNECTION para cambiar el nombre de la conexión que se acaba de crear a Mycon2. DISPLAY CONNECTIONS vuelve a usarse para mostrar la conexión con su nuevo nombre. Entonces, con DELETE CONNECTION se quita de la base de datos la conexión cuyo nombre se acaba de cambiar.

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
CREATE CONNECTION Myconn1 DATASOURCE "MyFoxSQLNT" USERID "sa"

CLEAR
DISPLAY CONNECTIONS  && Displays named connections in the database
RENAME CONNECTION Myconn1 TO Myconn2
DISPLAY CONNECTIONS  && Displays connection with new name

DELETE CONNECTION Myconn2  && Removes the connection just renamed

Vea también

DELETE CONNECTION | DBGETPROP( ) | DISPLAY CONNECTIONS | LIST CONNECTIONS | MODIFY CONNECTION | OPEN DATABASE