odbc_primarykeys

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_primarykeysLista las columnas utilizadas en una clave primaria

Descripción

odbc_primarykeys(
    Odbc\Connection $odbc,
    ?string $catalog,
    string $schema,
    string $table
): Odbc\Result|false

Devuelve un objeto resultado que puede ser utilizado para recuperar los nombres de las columnas que componen la clave primaria de una tabla.

Parámetros

odbc

El objeto de conexión ODBC, ver la documentación de la función odbc_connect() para más detalles.

catalog

El catálogo ('calificativo' en el argot ODBC 2).

schema

El esquema ('propietario' en el argot ODBC 2).

table

Valores devueltos

Devuelve un objeto de resultado ODBC o false si ocurre un error.

El conjunto de resultados contiene las siguientes columnas:

  • TABLE_CAT
  • TABLE_SCHEM
  • TABLE_NAME
  • COLUMN_NAME
  • KEY_SEQ
  • PK_NAME
Los controladores pueden indicar columnas adicionales.

El conjunto de resultados está ordenado por TABLE_CAT, TABLE_SCHEM, TABLE_NAME y KEY_SEQ.

Historial de cambios

Versión Descripción
8.4.0 odbc ahora espera una instancia de Odbc\Connection; anteriormente, se esperaba un resource.
8.4.0 Esta función ahora devuelve una instancia de Odbc\Result; anteriormente, se devolvía un resource.

Ejemplos

Ejemplo #1 Listar las Claves primarias de una Columna

<?php
$conn
= odbc_connect($dsn, $user, $pass);
$primarykeys = odbc_primarykeys($conn, 'TutorialDB', 'dbo', 'TEST');
while ((
$row = odbc_fetch_array($primarykeys))) {
print_r($row);
break;
// filas adicionales omitidas por brevedad
}
?>

Resultado del ejemplo anterior es similar a :

Array
(
    [TABLE_CAT] => TutorialDB
    [TABLE_SCHEM] => dbo
    [TABLE_NAME] => TEST
    [COLUMN_NAME] => id
    [KEY_SEQ] => 1
    [PK_NAME] => PK__TEST__3213E83FE141F843
)

Ver también