Demonstra Passo a passo: Criar e implantar um projeto de banco de dados que usa um objeto CLR em SQL

  • Artigo

Para criar e implantar um banco de dados que usa um conjunto de SQL Server Common Language Runtime (CLR SQL), você cria um o projeto de banco de dados e um projeto de SQL de CLR. Quando você criar e implanta o projeto de banco de dados, implantar automaticamente o assembly de SQL de CLR que ele faz referência ao mesmo tempo.

Esta explicação passo a passo, você executará as seguintes tarefas:

  • Criar um projeto de banco de dados simples.

  • Crie um projeto do CLR de SQL e definir um novo tipo de dados.

  • Use o tipo que você definiu no assembly CLR de SQL.

  • Criar e implantar o projeto de banco de dados.

Pré-requisitos

Para concluir este passo a passo, você deve ter instalado Visual Studio 2010 Premium. Você deve ter acesso a uma instância de SQL Server 2005 ou SQL Server 2008. Você deve ter instalado os exemplos de código para SQL Server da site CodePlex da. Você deve ter permissões para implantar um banco de dados ao seu servidor de banco de dados.

Criar um projeto de banco de dados

Para criar um projeto de banco de dados

  1. Sobre o arquivo , aponte para novae clique em projeto.

    A caixa de diálogo New Project será exibida.

  2. Em Modelos instalados, expanda o banco de dados nó e clique o SQL Server nó.

    ObservaçãoObservação

    Se você estiver usando Visual Studio 2010 Professional, você também deve expandir o Advanced nó antes de clicar em SQL Server.

  3. Na lista de modelos, clique em Projeto de banco de dados de 2008 do SQL Server.

  4. Em nome, digite SQLClrDatabaseSandbox.

    Observação importanteImportante

    Em local e Nome da solução, não altere os valores padrão.

  5. Selecione o Create directory for solution caixa de seleção se não estiver selecionada.

  6. Limpar o Add to Source Control caixa de seleção se ele já não estiver desmarcada e clique em OK.

    O projeto de banco de dados vazio aparece na Solution Explorer.

    Em seguida, você cria um projeto para o assembly CLR de SQL.

Criar um projeto do CLR de SQL

Para criar um projeto do CLR de SQL

  1. Sobre o arquivo , aponte para Adde clique em projeto.

    A caixa de diálogo New Project será exibida.

  2. Em tipos de projeto, expanda o banco de dados nó e clique em SQL Server.

  3. No modelos de lista, clique em Visual Basic SQL CLR banco de dados do Project Server Project ou C# SQL CLR banco de dados do projeto do Visual.

  4. Em nome, digite SupportingSQLClrObjects.

  5. Clique em OK para aceitar o local padrão, feche a caixa de diálogo e criar o projeto.

    O projeto de banco de dados vazio aparece na Solution Explorer.

  6. No Add Database Reference caixa de diálogo, clique em Cancelar.

    Clicando em Cancelar, ative o projeto de banco de dados determinar onde o assembly será implantado.

    Em seguida, você deve criar um tipo de dados personalizados no assembly SQL CLR.

Para definir um tipo de dados personalizado do CLR de SQL

  1. Sobre o projeto menu, clique em O tipo de Add User-Defined.

    O Add New Item caixa de diálogo aparece.

  2. Em nome, digite MyCustomType.cs.

    O code editor abre e exibe o conteúdo de MyCustomType.cs.

    ObservaçãoObservação

    Neste ponto, você deve modificar o tipo definido pelo usuário padrão para fornecer uma implementação que atenda às suas necessidades. Para esta explicação, você aceitará a implementação padrão. Para obter mais informações sobre como definir tipos personalizados e outros objetos CLR de SQL, consulte este tópico no site da Microsoft: Usando a integração CLR no SQL Server 2005.

  3. Sobre o arquivo menu, clique em Salvar MyCustomType.cs.

Para configurar e compilar o assembly CLR de SQL

  1. No menu Build, clique em Configuration Manager.

    O O Gerenciador de configuração caixa de diálogo aparece.

  2. Em contextos do projeto, limpar o Deploy caixa de seleção na linha para o assembly SupportingSQLClrObjects.

    Desmarcando a caixa de seleção, você pode impedir que o assembly do que está sendo implantada ao implantar a solução. Porque o assembly será implantado com o projeto de banco de dados, você não deseja que o assembly seja implantado duas vezes.

  3. Clique em Close.

  4. Em Solution Explorer, o botão direito do mouse no projeto SupportingSQLClrObjects e clique em Build.

    O assembly compila sem erros.

    Em seguida, fazer referência ao novo assembly e use o tipo que você definiu no assembly.

Use o tipo definido no Assembly CLR de SQL

Para usar o tipo que você definiu no assembly SQCLR, você deve adicionar uma referência de seu projeto de banco de dados para o assembly. Em seguida, defina o tipo de dados em seu projeto de banco de dados para que você possa usar este tipo de dados de novos nas definições de objeto.

Para adicionar uma referência ao assembly CLR de SQL

  1. Em Solution Explorer, expanda o projeto SQLClrDatabaseSandbox, com o botão direito do referências nó e clique em Adicionar referência de.

    ObservaçãoObservação

    Você também pode clicar no projeto SQLClrDatabaseSandbox na Solution Explorer, abra o projeto menu e clique Adicionar referência de.

    A caixa de diálogo Add Reference é aberta.

  2. Sobre o projetos guia, verifique se o projeto SupportingSQLClrObjects está realçado e clique em OK.

    Uma referência ao projeto SQL CLR é adicionada ao seu projeto de banco de dados.

  3. Em Solution Explorer, expanda o nó referências, clique no nó de SupportingSQLClrObjects e pressione F4.

    As propriedades da referência aparecem.

  4. Verifique Copy Local for definido como True e que O nível de permissão é definida como seguro.

  5. No Nome de Assembly propriedade, substitua SqlClassLibrary com SupportingSQLClrObjects.

  6. No proprietário propriedade, o tipo de dbo.

    Você pode especificar um proprietário diferente.

  7. No menu File, clique em Save All.

    As propriedades que você especificou a instrução CREATE ASSEMBLY que é criada quando você constrói o projeto de controle.

    Em seguida, você pode definir um tipo de dados que usa o assembly que o projeto SQL CLR produz.

Para definir o novo tipo de dados

  1. Sobre o Exibir menu, clique em Error List e Visualização do esquema de banco de dados.

  2. Expanda o nó de SQLClrDatabaseSandbox, expanda o nó esquemas, expanda o nó de dbo e expanda o nó de programação.

  3. Clique com o botão direito no nó tipos, aponte para Adde clique em CLR de tipo definido pelo usuário.

    O Add New Item caixa de diálogo aparece.

  4. Em modelos de, verifique se Tipo definido pelo usuário (CLR) é realçado.

  5. Em nome, tipo MyCustomTypee clique em Add.

    O Transact-SQL editor aparece e exibe a definição de tipo. No Error List janela, o seguinte erro é exibido:

SR0029 : Microsoft.Validation : User Defined Type: [dbo].[MyCustomType] has an unresolved reference to Assembly [assembly_name]

  1. No Transact-SQL editor, atualizar o código para coincidir com o seguinte:

    CREATE TYPE [dbo].[MyCustomType]
EXTERNAL NAME [SupportingSQLClrObjects].[MyCustomType]

  2. Sobre o arquivo menu, clique em Salvar MyCustomType.udtclr.sql.

    No Error List janela, o erro desaparece porque você atualizou a definição de tipo para se referir a um assembly válido e uma classe.

    Em seguida, você pode definir uma tabela simples que usa o novo tipo de dados.

Para usar o novo tipo de dados em uma definição de tabela

  1. Em Visualização Esquema, abra o nó esquemas e abra o nó de dbo.

  2. Clique com o botão direito no nó tabelas, aponte para Adde clique em tabela.

    O Add New Item caixa de diálogo aparece.

  3. Em modelos de, verifique se tabela é realçado.

  4. Em nome, tipo SimpleTablee clique em Add.

    O Transact-SQL editor aparece e exibe a definição da tabela.

  5. No Transact-SQL editor, atualizar o código para coincidir com o seguinte:

    CREATE TABLE [dbo].[SimpleTable]
(
column_1 int NOT NULL, 
column_2 [dbo].[MyCustomType] NULL
)

  6. Sobre o arquivo menu, clique em dbo de salvar.SimpleTable.table.sql.

    Em seguida, você pode configurar o projeto de banco de dados e, em seguida, implantá-lo para um o ambiente de desenvolvimento isolado.

Criar e implantar o projeto de banco de dados

Para definir as configurações de compilação

  1. Em Solution Explorer, clique em SQLClrDatabaseSandbox.

  2. Sobre o projeto menu, clique em Propriedades de SQLClrDatabaseSandbox.

  3. Clique o Build guia e reveja as configurações padrão.

    Esta explicação passo a passo, você pode usar as configurações padrão.

    Em seguida, você pode configurar as configurações de implantação.

Para definir as configurações de implantação

  1. Clique o Deploy guia.

  2. No A ação implantar , clique em criar um script de implantação (. SQL) e implantar banco de dados.

  3. No definir configurações de implantação para , clique em Meu ambiente de desenvolvimento isolado.

    Ao especificar essa configuração, você pode configurar valores que afetam o seu ambiente de desenvolvimento isolado. Você não irá alterar as configurações para o projeto de banco de dados.

  4. Em nome do script de implantação, aceite o valor padrão.

  5. Em Configurações de banco de dados de destino, clique em Editar para especificar uma conexão de destino.

  6. No Propriedades de conexão caixa de diálogo, especifique uma conexão com o servidor onde você deseja implantar o projeto de banco de dados do banco de dados e, em seguida, clique em OK.

  7. Em nome do banco de dados de destino, aceite o valor padrão.

  8. No arquivo de configuração de implantação , clique em Properties\Database.deploymentconfig.

    Por padrão, o seu ambiente de desenvolvimento isolado não está associado um conjunto de configurações de implantação detalhado. Quando você especificar este arquivo, você usará as configurações de implantação que estão associadas com o projeto de banco de dados. Você também pode criar um arquivo de configuração separado e modificar as configurações para seu ambiente de desenvolvimento isolado.

  9. No arquivo de variáveis do comando SQL , clique em Properties\Database.sqlcmdvars.

  10. No menu File, clique em Save All.

    Em seguida, você pode construir o projeto de banco de dados.

Para criar e implantar o projeto de banco de dados

  1. Sobre o Build menu, clique em Build Solution.

    O projeto de banco de dados e o projeto de conjunto SQL CLR compilar com êxito.

  2. On the Build menu, click Deploy Solution.

    O projeto de banco de dados e o assembly CLR de SQL são implantados no servidor de destino e o banco de dados especificado nas configurações de implantação. No saída janela, a seguinte mensagem aparece:

    ========== Implante: 1 foi bem-sucedida, falha de 0, 1 ignorada ==========.

    O projeto de banco de dados foi implantado com êxito. Quando você tiver implantado o projeto de banco de dados, também implantado o assembly CLR de SQL. O assembly CLR de SQL não tinha que ser implantados separadamente, por isso, ele foi ignorado quando você implantou a solução.

Disponibilizar o projeto para a equipe (opcional)

Para adicionar o projeto ao controle de versão

  1. Em Solution Explorer, clique na SQLClrDatabaseSandbox nó.

  2. Sobre o arquivo , aponte para O controle de origeme clique em Add Solution to Source Control.

    Neste ponto, você interage com o software de controle de versão instalada. Esta explicação passo a passo fornece as etapas para adicionar o projeto Visual Studio Team Foundation Server. Se você quiser usar software de controle de versão diferente, substitua as etapas equivalentes. Se você estiver usando Team Foundation Server, o conectar-se a Team Foundation Server de caixa de diálogo aparece.

  3. Em conectar a um de Team Foundation Server, clique no servidor que hospeda o projeto de equipe ao qual você deseja adicionar a sua solução.

    ObservaçãoObservação

    Se você não tiver um projeto de equipe ao qual você pode adicionar o projeto de banco de dados, consulte Planejando e acompanhando projetos.

  4. Em projetos de equipe, clique no projeto de equipe ao qual você deseja adicionar o projeto de banco de dados e, em seguida, clique em OK.

    O SQLClrDatabaseSandbox de solução adicionar ao controle de origem caixa de diálogo aparece.

  5. Clique em OK para aceitar os valores padrão.

    O projeto de banco de dados e os arquivos que ele contém são colocados sob controle de versão. Inicialmente, ainda retirados. Você deve fazer check-antes de outros membros da equipe possam acessá-los.

  6. Sobre o Exibir , aponte para Other Windowse clique em Alterações pendentes.

    O Alterações pendentes janela é exibida.

  7. No campo comentário, digite a criação de projeto de banco de dados inicial.

  8. No Alterações pendentes janela, clique em Check-In na barra de ferramentas.

    O Check In Progress caixa de diálogo aparece como o projeto de banco de dados e os arquivos que ele contém são check-in. Em Solution Explorer, os ícones se alteram para mostrar os arquivos são check-in para controle de versão.

Próximas etapas

Em seguida, você pode criar testes de unidade de banco de dados e um o plano de geração de dados para testar o assembly. Para obter mais informações, consulte Configurar projetos de banco de dados e executar uma implantação de teste.

Consulte também

Conceitos

Iniciando a equipe de desenvolvimento de bancos de dados

Iniciando a equipe de desenvolvimento de bancos de dados a outros bancos de dados de referência

Iniciando a equipe de desenvolvimento de bancos de dados que objetos de referência SQLCLR

Iniciando a equipe de desenvolvimento de bancos de dados para essa referência objetos de servidor compartilhados

Permissões necessárias para os recursos de banco de dados de Visual Studio