Méthode getBestRowIdentifier (SQLServerDatabaseMetaData)

  • Article

Télécharger le pilote JDBC

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