Академический Документы
Профессиональный Документы
Культура Документы
7 Votes Procedimiento Almacenado o StoreProcedures (En ingls) son unidades de cdigo compuestas por una o ms sentencias Transact-SQL o T-SQL y que son almacenados en el servidor. SPs nos dan la habilidad de extender el lenguaje T-SQL gracias a que podemos aadir nuestras propias subrutinas y procedimientos para las bases de datos SQL SERVER. Veamos la sintaxis.
CREATE PROCEDURE [ schema_name. ] procedure_name [ ;number ] [ ( ] [ { @parameter [ type_schema_name. ] data_type } [ VARYING ] [ = default ] [ OUT | OUTPUT ] ] [ , ...n ] [ ) ] [ WITHprocedure_option [ , ...n ] ] [ FOR REPLICATION ] AS { sql_statement [;][ ... n ] }
Como se pueden dar cuenta se inicia con un CREATE PROCEDURE seguido del nombre del SP. En el nombre se puede especificar el esquema, el nombre y el numero (opcional). El esquema siempre debe ser incluido ya que asegura que tu SP, es creado en el esquema apropiado. El procedure_name es el nombre que le asignamos a nuestro SP. Podemos aadir un numero para algun grupo, pero esto lo debemos hacer con un ;
AS SET NOCOUNT ON CREATE TABLE Prueba(id INT PRIMARY KEY NOT NULL); INSERT INTO Prueba(id)VALUES(1); RETURN
Este pequeo ejemplo crea una tabla en mi Base de Datos, e ingresa un valor en el campo de Identificador.
SET ANSI_NULLS ON
GO SET QUOTED_IDENTIFIER ON GO
executeSeleccionarProductos
Acceso a una base de datos de SQL Server con ADO.NET y Visual Basic
Publicado el 05/Feb/2006 Actualizado el 05/Feb/2006 Autor: Guillermo 'guille' Som
Cdigo de ejemplo vlido para cualquier versin de Visual Basic para .NET
Introduccin
Este artculo en realidad consta de varias partes, aunque todas esas partes formarn un todo, y ese todo es un ejemplo muy bsico (o elemental) de cmo acceder a una base de datos de tipo SQL Server usando ADO.NET y Visual Basic, (cualquier versin, ya sea la 1.x o la 2.0), permitiendo navegar entre los registros, aadir nuevos datos, modificar o borrar los existentes. Tambin veremos cmo saber las instancias de SQL Server que hay instaladas en el equipo, las cuales se mostrarn en un combo; al seleccionar la instancia, veremos cmo mostrar las bases de datos que tiene esa instancia, (excepto las del sistema o propias de SQL), las cuales estarn en otro combo. Si la tabla de prueba no existe en la base de datos seleccionada, tendremos la posibilidad de crearla. Adems de lo dicho, en este ejemplo tambin vers cmo hacer lo siguiente: -Deshabilitar los controles que estn incluidos en un GroupBox. -Conectar a la base de datos de SQL Server usando la autenticacin integrada de Windows. -Obtener todos los datos indicados en una orden SELECT y guardarlos en un DataTable. -Moverse por los registros de la tabla usando los tpicos comandos: Primero, Anterior, Siguiente y ltimo. -Aadir nuevos registros (o filas) a la tabla. -Eliminar una fila de la tabla. -Actualizar los datos de la fila actual. Y como valor aadido, la utilidad de ejemplo tambin tiene cdigo para: -Saber las instancias de SQL Server. -Saber las bases de datos de una instancia de SQL Server.
-Saber si una tabla en concreto existe en una base de datos de SQL. -Crear una tabla (la usada en esta aplicacin de ejemplo). Espero que te sea de utilidad y que est ms claro y menos "liante" que el otro ejemplo que ya tena publicado.
Nota: A lo largo de este artculo, te muestro el cdigo de Visual Basic, pulsa este link si quieres ver el artculo con el cdigo de ejemplo para C#.
Al final tienes el link al zip con el cdigo de ejemplo para Visual Basic, el cual es vlido tanto para las versiones 2003 y 2005.
Nos vemos Guillermo P.S. Pulsa aqu para ver un ejemplo parecido para una base de datos de tipo Access con OleDb.
Comentario
El formulario de la aplicacin de ejemplo Como vemos, este formulario utiliza los campos que tiene la tabla que vamos a usar, por tanto, si vas a usar otra tabla diferente a la usada en el ejemplo, tendrs que crear tu propio diseo del formulario. En el cdigo he intentado separar el cdigo que depende de los campos, de forma que te resulte fcil de modificar. Empezando por arriba, tenemos un ComboBox (cboInstancias) en el que mostraremos las instancias de SQL Server que hay instaladas en el equipo. Pulsa aqu si quieres saber cmo averiguar las instancias de SQL Server que hay en el equipo usando cdigo de Visual Basic. A la derecha, tenemos otro ComboBox (cboBases) en el que mostraremos las bases de datos que tiene la instancia de SQL Server que hayamos seleccionado del primer combo. Pulsa aqu para saber cmo averiguar las bases de datos que contiene una
instancia de SQL Server usando cdigo de Visual Basic. El botn que est en la parte derecha, (btnConectar), (en la misma fila que los dos combos) nos servir para conectarnos a la base de datos y a la instancia seleccionadas usando autenticacin de Windows. En ese botn se crea la conexin a la base de datos y se asigna el DataAdapter que usaremos para conectar directamente con la base de datos. Por tanto ser en el cdigo de ese botn donde tendrs que escribir todo lo necesario para realizar la conexin, cargar los datos en la tabla (DataTable) y empezar a mostrar los datos. Al pulsar en el botn de conectar, el cdigo comprueba si la tabla de pruebas existe, de no ser as, nos preguntar si la queremos crear. En el GroupBox tenemos los controles para mostrar los datos, navegar entre las filas, actualizar, crear y eliminar registros. Los botones de navegacin (o movimiento) nos servirn para ir a los distintos registros: Primero, anterior, siguiente y ltimo. El botn de Actualizar lo usaremos para actualizar los datos del registro actual. El botn Nuevo lo usaremos para aadir un nuevo registro. Cuando pulsamos en ese botn, se usarn los datos que actualmente tengamos en las cajas de textos, salvo el ID, ya que en la tabla de ejemplo es autonumrico, y por tanto se crea solo. El botn de Eliminar lo usaremos para eliminar el registro que est actualmente activo. Cuando se elimina el registro, los datos permanecen en los controles, por si queremos volver a crearlo, (pulsando en el botn Nuevo), aunque el ID usado ser diferente al mostrado, ya que al crear un nuevo registro (o fila) el valor del campo ID se genera automticamente.
Nota IMPORTANTE: Las tres operaciones indicadas se hacen directamente en la base de datos, es decir, no trabajamos en modo desconectado, sino que cualquier cambio se reflejar inmediatamente en la base de datos.
Me.Text = "Ejemplo acceso SQL Server VB" ' ' Limpiar los controles del GroupBox y ' deshabilitarlos hasta que se conecte a la base de datos ForEach c As Control InMe.GroupBox1.Controls ' Limpiar los textbox IfTypeOf c IsTextBoxThen c.Text = "" EndIf ' Deshabilitarlos c.Enabled = False Next
Me.GroupBox1.Enabled = False Me.GroupBox1.Text = "Debes conectar antes de usar los datos" ' ' Las instancias de SQL Server que hay instaladas Diminstancias() AsString instancias = instanciasInstaladas() ForEach s AsStringIninstancias If s = "MSSQLSERVER"Then cboInstancias.Items.Add("(local)") Else cboInstancias.Items.Add("(local)\"& s) EndIf Next cboInstancias.Text = "(local)"
' Los nombres de las bases de datos Dim bases() AsString = basesDeDatos("(local)") IfNot bases IsNothingThen Me.cboBases.Items.AddRange(bases) EndIf ' Seleccionamos la primera base IfMe.cboBases.Items.Count> 0 Then cboBases.SelectedIndex = 0 EndIf EndSub
Dim bases() AsString = basesDeDatos(cboInstancias.Text) Me.cboBases.Items.Clear() IfNot bases IsNothingThen Me.cboBases.Items.AddRange(bases) ' Seleccionamos la primera base IfMe.cboBases.Items.Count> 0 Then cboBases.SelectedIndex = 0 EndIf EndIf EndSub
En Visual Basic 2005 puedes usar este cdigo para saber si el array bases no contiene Nothing:
If bases IsNotNothingThen
Nota: En realidad el objeto SqlConnection no hace falta para rellenar los datos por medio del DataAdapter, pero si lo necesitamos para comprobar si la tabla existe.
Una vez que tenemos la conexin creada y que sabemos que la tabla existe, crearemos los objetos que nos permitirn acceder a la base de datos (mediante un
objeto del tipo SqlDataAdapter), y llenaremos el objeto DataTable con los datos que hayamos indicado en la cadena de seleccin. Crearemos los comandos que necesitaremos para actualizar los datos en la base de datos (UPDATE, INSERT y DELETE). Esos comandos los creamos con un objeto del tipoSqlCommandBuilder que aunque no es la forma ms efectiva, al menos es la ms fcil de usar, y como de lo que en este artculo se trata es que sea fcil, pues eso... Los comandos los asignaremos a los objetos correspondientes del adaptador, esto en realidad no es necesario, pero algunas veces me ha dado error al no hacerlo, as que... mejor estar seguros de que se asignan!. Debido a que la tabla de ejemplo utiliza un campo autoincremental, tendremos que asignar a la propiedad MissingSchemaAction el valor AddWithKey, de esta forma, al aadir nuevos registros se incrementar el valor del ID. En la tabla de ejemplo, estamos usando un campo que contiene caracteres que pueden ser conflictivos, en este caso es simplemente un guin, pero podra ser una vocal acentuada, una ee o contener espacios, en este caso lo que hacemos es indicar en el objeto del tipo CommandBuilder que utilice prefijo y sufijo para "envolver" automticamente esos campos conflictivos, esa indicacin la hacemos mediante las propiedades QuotePrefix y QuoteSufix. Por ltimo creamos el nuevo objeto del tipo DataTable, que ser el que usemos con el mtodo Fill del adaptador, al usar ese mtodo, ser cuando se conecte con la base de datos y asigne a la tabla los datos indicados en la cadena de seleccin (SELECT). En este ejemplo, le indico que traiga todos los datos, pero tambin podra haber seleccionado con una clusula WHERE otros diferentes.
Otra cosa importante que debemos tener en cuenta con el cdigo de seleccin (SELECT) es que si en lugar de indicar un asterisco para que se utilicen todos los campos ( SELECT * ), indicamos solo los campos que nos interesan, en las actualizaciones y lecturas de datos solo podremos incluir los campos indicados. Por ejemplo, si hacemos: SELECT ID, Nombre FROM Prueba, tan solo tendremos acceso a esos dos campos, y cualquier intento de acceder a otros campos (aunque sean vlidos y existan en la tabla) dar error.
Finalmente habilitamos nuevamente los controles que estn en el GroupBox para que podamos navegar, aadir, eliminar, actualizar y escribir en las cajas de texto, y mostraremos el primer registro, para ello llamamos al cdigo del evento del botn para mostrar el primer registro. Si no hay datos, (es decir, si la tabla no contiene alguna fila), deshabilitamos el botn de actualizar y el de eliminar, para permitir solo aadir nuevos datos.
PrivateSubbtnConectar_Click( _ ByVal sender AsSystem.Object, _ ByVal e AsSystem.EventArgs) _
HandlesbtnConectar.Click ' Conectar y mostrar los datos ' ' La cadena de conexin DimsCnnAsString = "Server="&cboInstancias.Text&"; "& _ "database="&cboBases.Text&"; integrated security=yes"
DimcnnAsNewSqlConnection(sCnn) IfexisteTabla(cnn, "Prueba") = FalseThen IfMessageBox.Show("NO existe la tabla Prueba, que es la usada para este ejemplo."&vbCrLf& _ "Quieres crearla?", "No existe la tabla", _ MessageBoxButtons.YesNo) = DialogResult.YesThen IfcrearTablaPrueba() = FalseThen ExitSub EndIf Else ExitSub EndIf EndIf
' La cadena de seleccin DimsSelAsString = "SELECT * FROM Prueba ORDER BY ID" ' ' Comprobar si hay algn error Try ' Crear un nuevo objeto del tipo DataAdapter da = NewSqlDataAdapter(sSel, sCnn) ' Crear los comandos de insertar, actualizar y eliminar DimcbAsNewSqlCommandBuilder(da) ' Como hay campos con caracteres especiales, ' al usarlos incluirlos entre corchetes. cb.QuotePrefix = "[" cb.QuoteSuffix = "]" ' Asignar los comandos al DataAdapter ' (se supone que lo hace automticamente, pero...) da.UpdateCommand = cb.GetUpdateCommand da.InsertCommand = cb.GetInsertCommand da.DeleteCommand = cb.GetDeleteCommand '
' Esta base de datos usa el ID con valores automticos da.MissingSchemaAction = MissingSchemaAction.AddWithKey ' dt = NewDataTable ' Llenar la tabla con los datos indicados da.Fill(dt) ' Me.GroupBox1.Enabled = True Me.GroupBox1.Text = "Conexin realizada" ' Habilitar los controles ForEach c As Control InMe.GroupBox1.Controls c.Enabled = True Next
' Y mostrar el primer registro Ifdt.Rows.Count> 0 Then btnFirst_Click(Nothing, Nothing) Else fila = -1 btnActualizar.Enabled = False btnEliminar.Enabled = False EndIf Catch ex As Exception MessageBox.Show("ERROR al conectar o recuperar los datos:"&vbCrLf& _ ex.Message, "Conectar con la base", _ MessageBoxButtons.OK, MessageBoxIcon.Error) EndTry EndSub
DimexisteAsBoolean = False ' Try Dim da AsNewSqlDataAdapter( _ "SELECT * FROM INFORMATION_SCHEMA.TABLES "& _ "WHERE TABLE_TYPE = 'BASE TABLE' "& _ "ORDER BY TABLE_TYPE", _ cnn) ' da.Fill(dt) ForEachdrAsDataRowIndt.Rows Ifdr("TABLE_NAME").ToString() = nombreTablaThen ReturnTrue EndIf Next ' Returnexiste
"[FechaAlta] [datetime] NULL,"& _ "[Comentario] [nvarchar](2048) COLLATE Modern_Spanish_CI_AS NULL,"& _ "CONSTRAINT [PK_Prueba] PRIMARY KEY CLUSTERED ("& _ "[ID] ASC)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY])"& _ " ON [PRIMARY]" DimcnnAsSqlConnection Try cnn = NewSqlConnection(sCnn) cnn.Open() DimcmdAsNewSqlCommand(sCmd, cnn)
cmd.ExecuteNonQuery() creada = True Catch ex As Exception MessageBox.Show("Error al crear la tabla:"&vbCrLf&ex.Message) Finally IfNotcnnIsNothingThen Ifcnn.State = ConnectionState.OpenThen cnn.Close() EndIf EndIf EndTry
Returncreada EndFunction
El hacerlo mediante ese mtodo es para que nos resulte ms cmo adaptar este ejemplo a otra tabla diferente a la que yo propongo, ya que en ese mtodo haramos todas las asignaciones que debamos hacer, salvo la del campo ID ya que al ser autonumrico no podemos asignarle un valor, porque ese valor lo asignar automticamente ADO.NET. Una vez que la fila tiene asignados los valores de los campos, la aadimos a las fila de la tabla. Esto es necesario, ya que el mtodo NewRow solo crea una fila, pero no la "relaciona" (o aade) a la tabla actual. Finalmente actualizamos los datos mediante el mtodo Update del adaptador. En realidad no hace falta hacer esa actualizacin en este preciso momento, pero si no lo hacemos, debemos aadir otro botn para que los datos se asignen a la base de datos, ya que al aadir un nuevo valor a la tabla, lo haremos en la "copia" que tenemos localmente en memoria, y no directamente en la base de datos, como ocurra, por ejemplo, con VB6 y los Recordsets. Una vez actualizados los datos en la base de datos, le indicamos a la tabla que acepte los cambios que hayamos hecho, de forma que quede sincronizada nuevamente. Esto es necesario, ya que si no lo hacemos, la tabla mantendr los cambios que hayamos hecho y si nuevamente "sincronizamos" esos datos con la base real, se podran producir errores.
Es importante que sepamos que cuando llamamos al mtodo Update del adaptador, se realizan todas las actualizaciones, es decir, no solo aadir nuevos datos, como "se supone" que es lo que hace este mtodo, sino que si hubisemos eliminado filas, o modificado algunas, esas modificaciones tambin se reflejaran en la base de datos.
Debido a cmo funcionan los campos autincrementales, para asegurarnos de que en realidad el valor de ese ID se actualiza correctamente, si es el primer registro que aadimos (o vale cero, como es la comprobacin que hacemos aqu), deberamos volver a leer los datos reales de la base de datos (que ser despus de haber aadido el primer registro) con idea de que ese ID tenga el valor correcto. Esto no es necesario en los siguientes datos que vayamos aadiendo, ya que en otros casos el valor del ID se asignar correctamente. Como ves, tambin controlamos los errores que se puedan producir... nunca est de ms!
PrivateSubbtnNuevo_Click( _ ByValsenderAsSystem.Object, _ ByVal e AsSystem.EventArgs) _ HandlesbtnNuevo.Click ' Crear un nuevo registro DimdrAsDataRow = dt.NewRow() ' Asignar los datos de los textbox a la fila
asignarDatos(dr)
' Aadir la nueva fila a la tabla dt.Rows.Add(dr) ' Guardar fsicamente los datos en la base Try da.Update(dt) dt.AcceptChanges() ' Si es el primer registro de la base, ' volver a leer los datos para actualizar los IDs IfCInt("0"&dr("ID").ToString) = 0 Then dt = NewDataTable da.Fill(dt) EndIf ' Posicionarlo en la ltima fila btnLast_Click(Nothing, Nothing) Catch ex AsDBConcurrencyException MessageBox.Show("Error de concurrencia:"&vbCrLf&ex.Message) Catch ex As Exception MessageBox.Show(ex.Message) EndTry EndSub
Si la caja de textos para la fecha no tiene nada, usamos un valor "nulo" para asignar a ese campo. De todas formas, deberamos usar un Try/Catch para comprobar que la fecha asignada es vlida.
PrivateSubasignarDatos(ByValdrAsDataRow) ' Usar los datos que hay en los textbox dr("Nombre") = txtNombre.Text dr("e-mail") = txtEmail.Text IftxtFechaAlta.Text = ""Then dr("FechaAlta") = DBNull.Value Else dr("FechaAlta") = txtFechaAlta.Text EndIf dr("Comentario") = txtComentario.Text EndSub
DimdrAsDataRow = dt.Rows(fila) ' Asignar los datos de los textbox a la fila asignarDatos(dr)
Try da.Update(dt) dt.AcceptChanges() Catch ex AsDBConcurrencyException MessageBox.Show("Error de concurrencia:"&vbCrLf&ex.Message) Catch ex As Exception MessageBox.Show(ex.Message) EndTry EndSub
Try ' Eliminar la fila de la tabla dt.Rows(fila).Delete() ' Actualizar fsicamente la base de datos da.Update(dt) ' Aceptar los cambios en la copia local dt.AcceptChanges() Catch ex AsDBConcurrencyException MessageBox.Show("Error de concurrencia:"&vbCrLf&ex.Message) Catch ex As Exception MessageBox.Show(ex.Message) EndTry
EndSub
Nota: Si lo que realmente te interesa es que los datos NO se eliminen directamente en la base de datos, (ni se actualicen ni creen nuevos), hasta que tu quieras, la llamada al mtodo Update del adaptador y la llamada al mtodo AcceptChanges de la tabla no deberas llamarla en estos tres mtodos que acabamos de ver, sino que puedes hacerlo, por ejemplo, cuando el usuario "realmente" quiera que todos esos cambios se hagan fsicamente en la base de datos. Pero eso es, como siempre, a tu criterio.
Moverse entre registros, con comandos para ir al primero, al ltimo, al anterior y al siguiente
Para movernos entre los registros usaremos cuatro mtodos, uno para ir al principio, otro para ir al final, otro para ir al registro anterior y otro para el siguiente. En estos cuatro mtodos usaremos un mtodo extra que ser el que se encargue de comprobar si todo est correcto (o casi) y de mostrar los datos adecuados en cada caja de texto. Al igual que antes con el mtodo asignarDatos, lo he puesto por separado, entre otras cosas para facilitar la modificacin del cdigo para otras tablas. Tambin para que no haya que estar repitiendo en el resto de los mtodos las comprobaciones de que el valor de fila indicado est dentro del rango vlido. Ese rango debe estar entre cero para el primer registro y uno menos del nmero total de filas para el ltimo, por tanto, si el valor del nmero de la fila indicado no es correcto, no hacemos nada, simplemente salimos del mtodo. En caso de que sigamos, quiere decir que es un valor de fila correcto, por tanto leemos esa fila (asignndola a una variable de tipo DataRow) y asignamos los valores a las cajas de texto, en este caso si que usamos el valor del campo ID con idea de que veamos ese valor. Por ltimo habilitamos el botn de actualizar y eliminar, ya que se supone que hay datos.
PrivateSubmostrarDatos(ByVal f AsInteger) DimufAsInteger = dt.Rows.Count - 1 If f < 0 OrElseuf< 0 ThenExitSub ' DimdrAsDataRow = dt.Rows(f) txtID.Text = dr("ID").ToString txtNombre.Text = dr("Nombre").ToString
txtEmail.Text = dr("e-mail").ToString txtFechaAlta.Text = dr("FechaAlta").ToString txtComentario.Text = dr("Comentario").ToString ' btnActualizar.Enabled = True btnEliminar.Enabled = True EndSub
Los cuatro mtodos para movernos son los siguientes, veamos que es lo que hacemos en cada uno de ellos, aunque creo que viendo el cdigo queda clara la intencin.
Nota: Como veremos en el cdigo, en realidad no hace falta pasarle ningn parmetro al mtodo mostrarDatos, ya que al tener la variable fila disponible en todo el formulario, pues podramos usar esa variable, pero... lo dejo as por si se te ocurre hacer cambios y no usar esa variable, que hay gente que no le gusta usar variables "globales" al formulario o clase...
Para ir al primero, simplemente asignamos cero a la variable de la fila actual y llamamos al mtodo de mostrar los datos.
PrivateSubbtnFirst_Click( _ ByVal sender AsSystem.Object, _ ByVal e AsSystem.EventArgs) _ HandlesbtnFirst.Click ' Posicionarse en la primera fila fila = 0 ' Mostrar los datos de la fila indicada mostrarDatos(fila) EndSub
Para ir al ltimo, averiguamos cual es la ltima fila, que como vemos es el valor devuelto por la propiedad Count de la coleccin de filas (Rows), menos uno, ya que como sabemos todos los arrays y colecciones de .NET siempre empiezan con el ndice cero.
PrivateSubbtnLast_Click( _ ByVal sender AsSystem.Object, _ ByVal e AsSystem.EventArgs) _ HandlesbtnLast.Click ' Posicionarse en la ltima fila fila = dt.Rows.Count - 1 ' Mostrar los datos de la fila indicada mostrarDatos(fila) EndSub
Para ir al anterior simplemente le restamos uno al valor de la fila actual, pero debemos hacer una comprobacin de que no sea menor de cero, ya que es posible que estemos en el primer registro y pulsemos en el botn de ir al anterior. En caso de que estemos en el primero, seguiremos en ese mismo registro.
PrivateSubbtnPrev_Click( _ ByVal sender AsSystem.Object, _ ByVal e AsSystem.EventArgs) _ HandlesbtnPrev.Click ' Posicionarse en la fila anterior fila = fila - 1 Iffila< 0 Thenfila = 0 ' Mostrar los datos de la fila indicada mostrarDatos(fila) EndSub
Por ltimo, para ir al siguiente, hacemos lo mismo que antes, pero en lugar de restar uno, lo que hacemos es aadir uno al valor de la fila actual, y en el caso de que sea mayor que la ltima fila, pues nos quedamos en esa ltima fila.
PrivateSubbtnNext_Click( _ ByVal sender AsSystem.Object, _ ByVal e AsSystem.EventArgs) _ HandlesbtnNext.Click ' Posicionarse en la fila siguiente DimufAsInteger = dt.Rows.Count - 1 fila = fila + 1 Iffila>ufThenfila = uf ' Mostrar los datos de la fila indicada mostrarDatos(fila)
EndSub