Méthode getBestRowIdentifier (SQLServerDatabaseMetaData)

Article
05/23/2023

Récupère une description du jeu optimal de colonnes d'une table qui identifie une ligne de façon unique.

Syntaxe

  
public java.sql.ResultSet getBestRowIdentifier(java.lang.String catalog,  
                                               java.lang.String schema,  
                                               java.lang.String table,  
                                               int scope,  
                                               boolean nullable)

Paramètres

catalog

Chaîne contenant le nom du catalogue.

schema

Chaîne contenant le nom du schéma.

table

Chaîne qui contient le nom de la table.

scope

int indiquant la portée d’intérêt. Quelques valeurs possibles :

bestRowTemporary (0)

bestRowTransaction (1)

bestRowSession (2)

nullable

true pour inclure les colonnes pouvant accepter la valeur Null. Dans le cas contraire, la valeur est false.

Valeur de retour

Objet SQLServerResultSet.

Exceptions

SQLServerException

Notes

Cette méthode getBestRowIdentifier est spécifiée par la méthode getBestRowIdentifier de l’interface java.sql.DatabaseMetaData.

Le jeu de résultats retourné par la méthode getBestRowIdentifier contient les informations suivantes :

Nom	Type	Description
SCOPE	short	Étendue des résultats retournés. Ce peut être l’une des valeurs suivantes : bestRowTemporary (0) bestRowTransaction (1) bestRowSession (2)
COLUMN_NAME	Chaîne	Nom de la colonne.
DATA_TYPE	short	Type de données SQL de java.sql.Types.
TYPE_NAME	String	Nom du type de données.
COLUMN_SIZE	int	Précision de la colonne.
BUFFER_LENGTH	int	Longueur du tampon.
DECIMAL_DIGITS	short	Échelle de la colonne.
PSEUDO_COLUMN	short	Indique si la colonne est une pseudo-colonne. Ce peut être l’une des valeurs suivantes : bestRowUnknown (0) bestRowNotPseudo (1) bestRowPseudo (2)

Exemple

L’exemple suivant montre comment utiliser la méthode getBestRowIdentifier pour retourner des informations sur le meilleur identificateur de ligne pour la table Person.Contact dans l’exemple de base de données AdventureWorks2022.

public static void executeGetBestRowIdentifier(Connection con) {  
   try {  
      DatabaseMetaData dbmd = con.getMetaData();  
      ResultSet rs = dbmd.getBestRowIdentifier(null, "Person", "Contact", 0, true);  
      ResultSetMetaData rsmd = rs.getMetaData();  
  
      // Display the result set data.  
      int cols = rsmd.getColumnCount();  
      while(rs.next()) {  
         for (int i = 1; i <= cols; i++) {  
            System.out.println(rs.getString(i));  
         }  
      }  
      rs.close();  
   }  
  
   catch (Exception e) {  
      e.printStackTrace();  
   }  
}

Voir aussi

Méthodes SQLServerDatabaseMetaData
SQLServerDatabaseMetaData, membres
SQLServerDatabaseMetaData, classe

Partager via