Metodo getProcedureColumns (SQLServerDatabaseMetaData)

Articolo
05/23/2023

Recupera una descrizione dei parametri delle stored procedure e delle colonne dei risultati.

Sintassi

  
public java.sql.ResultSet getProcedureColumns(java.lang.String sCatalog,  
                                              java.lang.String sSchema,  
                                              java.lang.String proc,  
                                              java.lang.String col)

Parametri

sCatalog

Valore String contenente il nome del catalogo. Se si specifica Null per questo parametro, non è necessario utilizzare il nome del catalogo.

sSchema

Valore String contenente il modello del nome dello schema. Se si specifica Null per questo parametro, non è necessario utilizzare il nome dello schema.

proc

Valore String contenente il modello del nome della procedura.

col

Valore String contenente il modello del nome della colonna. Se si specifica Null per questo parametro, viene restituita una riga per ogni colonna.

Valore restituito

Oggetto SQLServerResultSet.

Eccezioni

SQLServerException

Osservazioni

Questo metodo getProcedureColumns viene specificato dal metodo getProcedureColumns nell'interfaccia java.sql.DatabaseMetaData.

Il set di risultati restituito dal metodo getProcedureColumns conterrà le informazioni seguenti:

Nome	Tipo	Descrizione
PROCEDURE_CAT	Stringa	Nome del database in cui si trova la stored procedure specificata.
PROCEDURE_SCHEM	Stringa	Schema per la stored procedure.
PROCEDURE_NAME	Stringa	Nome della stored procedure.
COLUMN_NAME	Stringa	Nome della colonna.
COLUMN_TYPE	short	Tipo di colonna. Può essere uno dei valori seguenti: procedureColumnUnknown (0) procedureColumnIn (1) procedureColumnInOut (2) procedureColumnOut (4) procedureColumnReturn (5) procedureColumnResult (3)
DATA_TYPE	smallint	Tipo di dati SQL da java.sql.Types.
TYPE_NAME	Stringa	Nome del tipo di dati.
PRECISION	int	Numero totale di cifre significative.
LENGTH	int	Lunghezza dei dati in byte.
SCALE	short	Numero di cifre a destra del separatore decimale.
RADIX	short	Base per i tipi numerici.
NULLABLE	short	Indica se la colonna può contenere un valore Null. Può essere uno dei valori seguenti: procedureNoNulls (0) procedureNullable (1) procedureNullableUnknown (2)
REMARKS	Stringa	Descrizione della colonna della procedura. Nota: SQL Server non restituisce alcun valore per questa colonna.
COLUMN_DEF	Stringa	Valore predefinito della colonna.
SQL_DATA_TYPE	smallint	Questa colonna corrisponde alla colonna DATA_TYPE, tranne che per i tipi di dati datetime e ISO interval.
SQL_DATETIME_SUB	smallint	Sottocodice datetime ISO interval se il valore di SQL_DATA_TYPE è SQL_DATETIME o SQL_INTERVAL. Per i tipi di dati diversi da datetime e ISO interval, questa colonna è NULL.
CHAR_OCTET_LENGTH	int	Numero massimo di byte nella colonna.
ORDINAL_POSITION	int	Indice della colonna all'interno della tabella.
IS_NULLABLE	Stringa	Indica se la colonna ammette valori Null.
SS_TYPE_CATALOG_NAME	Stringa	Nome del catalogo contenente il tipo definito dall'utente (UDT).
SS_TYPE_SCHEMA_NAME	Stringa	Nome dello schema contenente il tipo definito dall'utente (UDT).
SS_UDT_CATALOG_NAME	Stringa	Tipo definito dall'utente (UDT) del nome completo.
SS_UDT_SCHEMA_NAME	Stringa	Nome del catalogo in cui viene definito il nome di una raccolta di XML Schema. Se non è possibile trovare il nome del catalogo, questa variabile contiene una stringa vuota.
SS_UDT_ASSEMBLY_TYPE_NAME	Stringa	Nome dello schema in cui viene definito il nome di una raccolta di XML Schema. Se non è possibile trovare il nome dello schema, viene visualizzata una stringa vuota.
SS_XML_SCHEMACOLLECTION_CATALOG_NAME	Stringa	Nome di una raccolta di XML Schema. Se non è possibile trovare il nome, viene visualizzata una stringa vuota.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME	Stringa	Nome del catalogo contenente il tipo definito dall'utente (UDT).
SS_XML_SCHEMACOLLECTION_NAME	Stringa	Nome dello schema contenente il tipo definito dall'utente (UDT).
SS_DATA_TYPE	tinyint	Tipo di dati di SQL Server usato in stored procedure estese. Nota: per altre informazioni sui tipi di dati restituiti da SQL Server, vedere "Tipi di dati (Transact-SQL)" nella documentazione online di SQL Server.

Nota

Per altre informazioni sui dati restituiti dal metodo getProcedureColumns, vedere "sp_sproc_columns (Transact-SQL)" nella documentazione online di SQL Server.

Esempio

Nell'esempio seguente viene illustrato come utilizzare il metodo getProcedureColumns per restituire informazioni sulla stored procedure uspGetBillOfMaterials nel database di esempio AdventureWorks2022.

public static void executeGetProcedureColumns(Connection con) {  
   try {  
      DatabaseMetaData dbmd = con.getMetaData();  
      ResultSet rs = dbmd.getProcedureColumns(null, null, "uspGetBillOfMaterials", null);  
      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();  
   }  
}

Vedere anche

Membri di SQLServerDatabaseMetaData
Classe SQLServerDatabaseMetaData

Condividi tramite