Compartilhar via


Criar e implantar um banco de dados vazio (AMO-TOM)

Aplica-se a: SQL Server 2016 e posteriores do Analysis Services Azure Analysis Services Fabric/Power BI Premium

Um cenário de programação comum para AMO-TOM é gerar bancos de dados e modelos em tempo real. Este artigo orienta você pelas etapas de criação de um banco de dados.

Para soluções tabulares, há uma correspondência um-para-um entre um banco de dados e um modelo, com um modelo por banco de dados. Normalmente, você pode especificar um ou outro, e o mecanismo inferirá o objeto ausente.

Criar e implantar um novo banco de dados é uma tarefa de três partes:

  • Instancie um objeto Database e defina suas propriedades, incluindo um nome.

  • Adicione o objeto Database a uma coleção Server.Databases .

  • Chame o método Update no objeto Database para salvá-lo no Servidor.

Exemplo de código: criar um banco de dados vazio

using System; 
using Microsoft.AnalysisServices; 
using Microsoft.AnalysisServices.Tabular; 
 
namespace TOMSamples 
{ 
    class Program 
    { 
        static void Main(string[] args) 
        { 
            // 
            // Connect to the local default instance of Analysis Services 
            // 
            string ConnectionString = "DataSource=localhost"; 
 
            // 
            // The using syntax ensures the correct use of the 
            // Microsoft.AnalysisServices.Tabular.Server object. 
            // 
            using (Server server = new Server()) 
            { 
                server.Connect(ConnectionString); 
 
                // 
                // Generate a new database name and use GetNewName 
                // to ensure the database name is unique. 
                // 
                string newDatabaseName = 
                    server.Databases.GetNewName("New Empty Database"); 
 
                // 
                // Instantiate a new  
                // Microsoft.AnalysisServices.Tabular.Database object. 
                // 
                var blankDatabase = new Database() 
                { 
                    Name = newDatabaseName, 
                    ID = newDatabaseName, 
                    CompatibilityLevel = 1200, 
                    StorageEngineUsed = StorageEngineUsed.TabularMetadata, 
                }; 
                // 
                // Add the new database object to the server's  
                // Databases connection and submit the changes 
                // with full expansion to the server. 
                // 
                server.Databases.Add(blankDatabase); 
                blankDatabase.Update(UpdateOptions.ExpandFull); 

                Console.Write("Database "); 
                Console.ForegroundColor = ConsoleColor.Yellow; 
                Console.Write(blankDatabase.Name); 
                Console.ResetColor(); 
                Console.WriteLine(" created successfully."); 
                Console.WriteLine(); 
            } 
            Console.WriteLine("Press Enter to close this console window."); 
            Console.ReadLine(); 
        } 
    } 
} 

Próximas etapas

Depois que um banco de dados é criado, você pode adicionar objetos Model:

Adicionar uma fonte de dados a um modelo tabular
Criar tabelas, partições e colunas em um modelo tabular