Sobre o objeto modelo do PowerPivot no Excel

Saiba mais sobre o modelo de suplemento do PowerPivot e seu modelo de objeto no Excel.

O suplemento do PowerPivot permite que você crie visualmente seus próprios cubos. Um cubo de dados é uma matriz de dados definida em dimensões ou camadas. O objeto Model no Excel implementado pelo suplemento do PowerPivot fornece a base para carregar e combinar dados de origem de várias fontes de dados para análise de dados na área de trabalho, incluindo bancos de dados relacionais, fontes multidimensionais, serviços de nuvem, feeds de dados, arquivos do Excel, arquivos de texto e dados da Web. O Excel integra fontes de dados adicionais e permite a capacidade de combinar dados de várias fontes de dados.

A criação e exclusão do PowerPivot Model (PPM) é disparada por ações expostas pelo usuário e não pode ser criada diretamente pelo desenvolvedor.

Relações definidas

Ao longo deste artigo, vamos nos referir à conexão entre duas tabelas que estabelece como os dados devem ser correlacionados como relações.

As relações unem dados de fontes de dados não relacionadas anteriormente. Cada relação tem uma chave primária e uma chave estrangeira. As relações permitem que os dados sejam unidos em um único modelo. Isso permite:

• Filtrar dados em uma tabela por dados em uma tabela relacionada
• Filtrando dados por colunas relacionadas
• Integrando colunas de várias tabelas em uma Tabela Dinâmica/Gráfico Dinâmico
• Manter as pastas de trabalho menores por não precisar repetir dados

Somente modelos únicos

O Excel com o suplemento do PowerPivot cria um único modelo na pasta de trabalho ao qual ele pode adicionar fontes de dados, criar, modificar e relacionar tabelas. Só pode haver um único modelo em uma pasta de trabalho.

Trabalhando com fontes de dados OLAP

Ao se conectar a uma fonte de dados OLAP, como o Analysis Services, e criar tabelas dinâmicas OLAP, Gráficos Dinâmicos, Segmentações ou funções cube, nenhum modelo é criado. As pastas de trabalho criadas com o suplemento do PowerPivot podem ser carregadas no SharePoint, carregadas na memória no servidor e acessadas por outras pastas de trabalho como se fosse uma instância normal de SQL Server Analysis Services.

Disparar a criação de um modelo do PowerPivot

Por padrão, os arquivos XLSX no Excel 2010 e no Excel não têm um PPM inicializado neles até que o modelo seja considerado necessário. Determinadas ações disparam a criação de um PPM se não houver nenhum modelo existente na pasta de trabalho. As seções a seguir descrevem as ações que dispararão a criação de um PPM quando ele não existir na pasta de trabalho.

Adicionar uma nova fonte de dados não herdada

Sempre que você importa determinados tipos de dados, um novo modelo é criado na pasta de trabalho (se ainda não existir) que contém as propriedades de conexão, a representação de tabela das fontes de dados da pasta de trabalho e as relações entre elas. Isso inclui fontes de dados internas, como intervalos e tabelas. A tabela a seguir lista as diferentes fontes de dados que podem ser integradas ao PPM.

Data Source	Descrição	Visualização da tabela	Com suporte para consulta
Microsoft SQL Server	Já há suporte no Excel	Sim	Sim
Microsoft SQL Azure Data Market	Com suporte como uma nova fonte de dados do feed de dados	Sim	Não
Microsoft SQL Server Parallel Data Warehouse	Com suporte por meio do driver OLE DB instalado	Sim	Sim
Microsoft Access	Já há suporte no Excel	Sim	Sim
Oracle	Já há suporte no Excel	Sim	Sim
Teradata	Disponível se o driver OLE DB ou ODBC estiver instalado	Não	Não
Sybase	Disponível se o driver OLE DB ou ODBC estiver instalado	Não	Não
Informix	Disponível se o driver OLE DB ou ODBC estiver instalado	Não	Não
IBM Db2	Disponível se o driver OLE DB ou ODBC estiver instalado	Não	Não
Microsoft Analysis Services	Já há suporte no Excel	Sim	Sim
Relatório (SSRS)	Pode ler e usar conexões, mas nenhuma criação no cliente do Excel	Sim	Não
Texto	Na caixa de diálogo do Excel na interface do usuário da faixa de opções	Sim	Não
Feeds de Dados (OData)	Com suporte como uma nova fonte de dados	Sim	Sim
XML	Já há suporte no Excel	Não	Não
Listas do SharePoint	Já há suporte no Excel. O Excel usa o provedor do DataFeed para se conectar ao SharePoint	Não	Não
Microsoft Office SharePoint Online	Novo recurso no Excel	Sim	Sim
Tabelas do Excel	Tabela definida pelo usuário no Excel usada para novo recurso de dados. Uma conexão de dados de planilha é criada para a tabela quando a tabela é criada.	N/D	N/D
Intervalos do Excel	Intervalo definido pelo usuário no Excel usado para novo recurso de dados. Uma conexão de dados de planilha nesse caso é criada para o intervalo somente se um recurso de dados como um gráfico ou Tabela Dinâmica usar o intervalo.	N/D	N/D

Criar uma nova Tabela Dinâmica não OLAP do Excel

Novas Tabelas Dinâmicas do Excel, que não sejam as criadas a partir de uma fonte de dados OLAP, serão baseadas em um PPM, portanto, se um PPM não estiver presente no arquivo, um novo será criado como parte da ação de criação da Tabela Dinâmica. Isso inclui:

• Usando a interface do usuário inserir Tabela Dinâmica
• Resumindo dados com a interface do usuário da Tabela Dinâmica
• Tabela Dinâmica baseada em uma fonte de dados não OLAP criada por meio do modelo de objeto VBA (Microsoft Visual Basic for Applications)

Criar um novo Gráfico Dinâmico não OLAP do Excel

No Excel, Tabelas Dinâmicas e Gráficos Dinâmicos têm a capacidade de não serem mais acoplados. Portanto, na inserção de um Gráfico Dinâmico em uma pasta de trabalho sem um modelo, um PPM será criado.

Colar tabelas dinâmicas não OLAP do Excel de outra pasta de trabalho

Ao colar uma Tabela Dinâmica ou Gráfico Dinâmico de outra pasta de trabalho baseada em um PPM em uma que não tenha um PPM, um novo PPM será criado na pasta de trabalho de destino. Uma nova fonte de dados será adicionada ao modelo recém-criado apontando para os dados subjacentes da Tabela Dinâmica/Gráfico Dinâmico de origem.

Desfazer a criação de um modelo do PowerPivot

Todas as ações que levam à criação de um PPM podem ser desfeitas. Se essas ações forem selecionadas no menu desfazer, a criação real do modelo não será desfeita, mas nada será adicionado a ela; portanto, ele permanecerá vazio. Quando a pasta de trabalho for salva, se o modelo estiver vazio, o modelo não será salvo com o arquivo. Não há uma maneira explícita de excluir manualmente um modelo criado na pasta de trabalho.

Observação

Semelhante ao comportamento no Excel 2010, há uma restrição em quais tamanhos de modelo podem ser desfeitos. Quando um modelo aumenta para essa funcionalidade de desfazer tamanho limite para ações como atualização, não será mais fornecido. O limite atual para tabelas dinâmicas nativas é de 300.000 linhas, a 28 bytes de uma célula esse limite é de aproximadamente 8MB na memória. Esses valores podem ser definidos usando Opções Avançadas no Excel, conforme mostrado na figura a seguir.

O modelo de objeto Do PowerPivot

Uma pasta de trabalho poderá ter um e apenas um objeto Model . O objeto Model representa o objeto de nível superior que contém todas as suas conexões, relações e tabelas.

Você não é capaz de criar manualmente um modelo em uma pasta de trabalho; A criação do modelo é disparada por meio das ações descritas em uma seção anterior neste artigo. Se alguma dessas ações for executada por meio do OM (Modelo de Objeto), um novo modelo será criado. A finalidade deste OM é para a criação programática de relações entre tabelas de modelo que resultam em tabelas unidas, combinando Tabelas Dinâmicas e assim por diante. Para que você possa fazer isso, você deve ser capaz de explorar o modelo para encontrar as tabelas apropriadas e dentro das tabelas encontrar as colunas apropriadas que seriam usadas para criar a relação.

Objeto Model

O objeto Model armazena referências a conexões de pasta de trabalho e informações sobre as tabelas e relações contidas no PPM. A tabela a seguir lista as propriedades do objeto Model .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai do objeto Model especificado.
ModelTables	Somente leitura	ModelTable	Coleção de tabelas dentro do PPM.
ModelRelationships	Somente leitura	ModelRelationships	Coleção de relações entre tabelas PPM.
DataModelConnection	N/D	WorkbookConnection	Retorna o objeto de conexão de pasta de trabalho modelo da coleção de conexões de pasta de trabalho que se conecta ao modelo.

Método Model.AddConnection

Adiciona uma nova conexão de pasta de trabalho ao modelo com as mesmas propriedades que a fornecida como argumento. Esse método só funciona em conexões externas não modelo e retornará um erro se for chamado com uma conexão de modelo externo como argumento. Ao chamar esse método, uma nova conexão de modelo é criada e é nomeada como a mesma que a conexão herdada com um inteiro no final para tornar o nome exclusivo. A tabela a seguir lista os parâmetros do método AddConnection .

Name	Obrigatório/opcional	Tipo	Descrição
ConnectionToDataSource	Obrigatório	WorkbookConnection	A conexão da pasta de trabalho

Método Model.CreateModelWorkbookConnection

Chamar esse método retorna um objeto WorkbookConnection do tipo ModelConnection. Uma conexão de modelo conectada à tabela especificada é retornada. Esse tipo de conexão só pode ser usado por tabelas de consulta no Excel. A tabela a seguir lista os parâmetros do método CreateModelWorkbookConnection .

Name	Obrigatório/opcional	Tipo	Descrição
ModelTable	Obrigatório	Variantes	Um nome de tabela de modelo ou um objeto de tabela de modelo.

Método Model.Initialize

O método Initialize do objeto Model não tem parâmetros. Inicializa o PPM. Isso é chamado por padrão na primeira vez que o modelo é usado.

Método Model.Refresh

O método Refresh do objeto Model não tem parâmetros. Atualiza todas as fontes de dados associadas ao modelo, reprocessa totalmente o modelo e atualiza todos os recursos de dados do Excel associados ao objeto Model .

Objeto ModelChanges

Representa as alterações feitas no PPM. O objeto ModelChanges contém informações sobre quais alterações foram feitas no modelo de dados quando o evento Workbook.ModelChange ocorre após uma operação de modelo. Quando o Excel faz alterações no modelo de dados, várias alterações podem ser feitas na mesma operação e o objeto ModelChanges incluirá informações sobre todas as alterações feitas em uma operação de modelo. A tabela a seguir lista as propriedades do objeto ModelChanges .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
ColumnsAdded	Somente leitura	ModelColumnNames	Retorna uma coleção ModelColumnNames de objetos ModelColumnName que representam todas as colunas adicionadas como parte de uma operação de modelo.
ColumnsChanged	Somente leitura	ModelColumnChanges	Retorna uma coleção ModelColumnChanges de objetos ModelColumnChange que representam nomes de tabela e nomes de coluna de todas as colunas de tabela para as quais o tipo de dados foi alterado como parte de uma operação de modelo.
ColumnsDeleted	Somente leitura	ModelColumnNames	Retorna uma coleção ModelColumnNames de objetos ModelColumnName que representam todas as colunas que foram excluídas como parte de uma operação de modelo.
MeasuresAdded	Somente leitura	ModelMeasureNames	Retorna uma coleção ModelMeasureNames de objetos ModelMeasureName que representam todas as medidas que foram adicionadas como parte de uma operação de modelo.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai do objeto ModelChanges especificado.
RelationshipChange	Somente leitura	Boolean	Quando True, uma ou mais relações no modelo foram alteradas (adicionadas, excluídas ou modificadas) como parte de uma operação de modelo. Quando False, nenhuma relação foi alterada durante a operação.
TableNamesChanged	Somente leitura	ModelTableNameChanges	Retorna uma coleção ModelTableNameChanges de objetos ModelTableNameChange que representa nomes antigos e novos de todas as tabelas que foram renomeadas no modelo como parte de uma operação de modelo.
TablesAdded	Somente leitura	ModelTableNames	Retorna uma coleção ModelTableNames de nomes de tabela como cadeias de caracteres que representa todas as tabelas que foram adicionadas ao modelo como parte de uma operação de modelo.
TablesDeleted	Somente leitura	ModelTableNames	Retorna uma coleção ModelTableNames de nomes de tabela como cadeias de caracteres que representa todas as tabelas que foram excluídas do modelo como parte de uma operação de modelo.
TablesModified	Somente leitura	ModelTableNames	Retorna uma coleção ModelTableNames de nomes de tabela como cadeias de caracteres que representa todas as tabelas que foram atualizadas ou recalculadas como parte de uma operação de modelo.
UnknownChange	Somente leitura	Boolean	True quando uma alteração não especificada foi feita no modelo como parte de uma transação de modelo.

Coleção ModelColumnChanges

Uma coleção de objetos ModelColumnChange que representam colunas para as quais o tipo de dados foi alterado no PPM. A tabela a seguir lista as propriedades da coleção ModelColumnChanges .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Count	Somente leitura	Long	Retorna o número de objetos ModelColumnChange na coleção
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai do objeto ModelColumnChanges especificado.

Método ModelColumnChanges.Item

Retorna um único objeto da coleção ModelColumnChanges . A tabela a seguir lista os parâmetros do método Item .

Name	Obrigatório/opcional	Tipo	Descrição
Índice	Obrigatório	Variantes	O número de índice ou o nome do objeto.

Objeto ModelColumnChange

Um objeto que representa uma coluna em uma tabela no PPM para o qual o tipo de dados foi alterado. A tabela a seguir lista as propriedades do objeto ModelColumnChange .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
ColumnName	Somente leitura	String	Cadeia de caracteres que representa o nome de uma coluna para a qual o tipo de dados foi alterado.
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um objeto que representa o objeto pai do objeto ModelColumnChange especificado.
TableName	Somente leitura	String	Cadeia de caracteres que representa o nome de uma tabela no PPM para a qual o tipo de dados de uma coluna foi alterado.

Coleção ModelColumnNames

Uma coleção de objetos ModelColumnName que representa colunas de tabelas no PPM. A tabela a seguir lista as propriedades da coleção ModelColumnNames .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Count	Somente leitura	Long	Retorna o número de objetos ModelColumnName na coleção
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um objeto que representa o objeto pai da coleção ModelColumnNames especificada.

Método ModelColumnNames.Item

Retorna um único objeto da coleção ModelColumnNames . A tabela a seguir lista os parâmetros do método Item

Name	Obrigatório/opcional	Tipo	Descrição
Índice	Obrigatório	Variantes	O número de índice ou o nome do objeto.

Objeto ModelColumnName

Um objeto que representa o nome de uma coluna no PPM. A tabela a seguir lista as propriedades do objeto ModelColumnName .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
ColumnName	Somente leitura	String	Cadeia de caracteres que representa o nome de uma coluna da tabela identificada pela propriedade TableName .
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um objeto que representa o objeto pai do objeto ModelColumnName especificado.
TableName	Somente leitura	String	Cadeia de caracteres que representa o nome de uma tabela no PPM.

Objeto ModelConnection

O objeto ModelConnection conterá informações para o novo Tipo de Conexão de Modelo introduzido no Excel para interagir com o PPM integrado. A tabela a seguir lista as propriedades do objeto ModelConnection .

Propriedade	Leitura/gravação	Tipo	Descrição
ADOConnection	Somente leitura	ADOConnection	Usado para criar uma conexão aberta com uma fonte de dados. Permite que suplementos, como o PowerViewer, criem uma conexão direta com o mecanismo e, portanto, o modelo de dados.
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
CommandText	Leitura/gravação	Variantes	Retorna ou define a cadeia de caracteres de comando para a fonte de dados (tabela) especificada.
CommandType	Leitura/gravação	xlCmdType	Retorna ou define uma das constantes xlCmdType que especificam o tipo de comando.
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai do objeto ModelConnection especificado.

Coleção ModelMeasureNames

A coleção ModelMeasureNames contém uma coleção de objetos ModelMeasureName no PPM. A tabela a seguir lista as propriedades da coleção ModelMeasureNames .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Count	Somente leitura	Long	Retorna o número de objetos ModelMeasureName na coleção
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um objeto que representa o objeto pai da coleção ModelMeasureNames especificada.

Método ModelMeasureNames.Item

Retorna um único objeto da coleção ModelMeasureNames . A tabela a seguir lista os parâmetros do método Item .

Name	Obrigatório/opcional	Tipo	Descrição
Índice	Obrigatório	Variantes	O número de índice ou o nome do objeto.

Objeto ModelMeasureName

Um objeto que representa o nome de uma medida no PPM. A tabela a seguir lista as propriedades do objeto ModelMeasureName .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
MeasureName	Somente leitura	String	Cadeia de caracteres que representa o novo nome uma medida que foi adicionada ao objeto ModelTable identificado pela propriedade TableName .
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um objeto que representa o objeto pai do objeto ModelMeasureName especificado.
TableName	Somente leitura	String	Cadeia de caracteres que representa o nome de uma tabela no PPM.

Coleção ModelRelationships

A coleção ModelRelationships contém uma coleção de objetos ModelRelationship no PPM. A tabela a seguir lista as propriedades da coleção ModelRelationships .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Count	Somente leitura	Long	Retorna o número de objetos ModelRelationship na coleção
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai da coleção ModelRelationships especificada.

Método ModelRelationships.Add

Adiciona uma relação à coleção ModelRelationships . A tabela a seguir lista os parâmetros do método Add .

Name	Obrigatório/opcional	Tipo	Descrição
ForeignKeyColumn	Obrigatório	ModelTableColumn	Um objeto ModelTableColumn que representa a coluna de chave estrangeira na tabela em muitos lados da relação de um para muitos.
PrimaryKeyColumn	Obrigatório	ModelTableColumn	Um objeto ModelTableColumn que representa a coluna de chave primária na tabela de um lado da relação de um para muitos.

Método ModelRelationships.Item

Retorna um único objeto da coleção ModelRelationships . A tabela a seguir lista os parâmetros do método Item .

Name	Obrigatório/opcional	Tipo	Descrição
Índice	Obrigatório	Variantes	O número de índice ou o nome do objeto.

Objeto ModelRelationship

Represente uma relação entre objetos ModelTableColumn . Usado ao criar relações programaticamente. A tabela a seguir lista as propriedades do objeto ModelRelationship .

Propriedade	Leitura/gravação	Tipo	Descrição
Active	Leitura/gravação	Boolean	Quando True, a relação está ativa.
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
ForeignKeyColumn	Somente leitura	ModelTableColumn	Contém o objeto ModelTableColumn que representa a coluna de chave estrangeira em muitos lados da relação de um para muitos.
ForeignKeyTable	Somente leitura	ModelTable	Contém o objeto ModelTable que representa a tabela no lado muitos da relação de um para muitos.
Responsável	Somente leitura	Object	Retorna um objeto modelo object que representa o modelo em que o objeto ModelRelationship reside.
PrimaryKeyColumn	Somente leitura	ModelTableColumn	Contém o objeto ModelTableColumn que representa a coluna de chave primária na tabela de um lado da relação de um para muitos.
PrimaryKeyTable	Somente leitura	ModelTable	Contém o objeto ModelTable que representa a tabela de um lado da relação de um para muitos.

Método ModelRelationship.Delete

O método Delete do objeto ModelRelationship não tem parâmetros. Exclui uma relação.

Coleção ModelTables

A coleção ModelTables contém uma coleção de objetos ModelTable no PPM. A tabela a seguir lista as propriedades da coleção ModelTables .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Count	Somente leitura	Long	Retorna o número de objetos ModelTable na coleção
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai da coleção ModelTables especificada.

Método ModelTables.Item

Retorna um único objeto da coleção ModelTables . A tabela a seguir lista os parâmetros do método Item.

Name	Obrigatório/opcional	Tipo	Descrição
Índice	Obrigatório	Variantes	O número de índice ou o nome do objeto.

Objeto ModelTable

Represente uma tabela no objeto Model . O objeto ModelTable é lido apenas, o que significa que ele não pode ser criado ou editado por meio do modelo de objeto. Há um objeto ModelTable para cada tabela do modelo. A tabela a seguir lista as propriedades do objeto ModelTable .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
ModelTableColumns	Somente leitura	ModelTableColumns	Coleção de objetos ModelTableColumn que compõem o objeto ModelTable .
Nome	Somente leitura	String	Retorna o nome do objeto ModelTable .
Responsável	Somente leitura	Object	Retorna um Objeto que representa o modelo em que o objeto ModelTable reside.
RecordCount	Somente leitura	Integer	Retorna a contagem total de linhas para o objeto ModelTable .
SourceName	Somente leitura	String	Nome da tabela na fonte de dados. Se a tabela não tiver nenhuma fonte de dados (criada no modelo), a propriedade retornará um erro.
SourceWorkbookConnection	Somente leitura	WorkbookConnection	Retorna a conexão da pasta de trabalho da qual o objeto ModelTable se originou.

Método ModelTable.Refresh

O método Refresh do objeto ModelTable não tem parâmetros. Atualiza as conexões de origem da tabela de modelo.

Coleção ModelTableColumns

A coleção ModelTableColumns contém uma coleção de objetos ModelTableColumn no PPM. A tabela a seguir lista as propriedades da coleção ModelTableColumns .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Count	Somente leitura	Long	Retorna o número de objetos ModelTableColumn na coleção
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai da coleção ModelTableColumns especificada.

Método ModelTableColumns.Item

Retorna um único objeto da coleção ModelTableColumns . A tabela a seguir lista os parâmetros do método Item .

Name	Obrigatório/opcional	Tipo	Descrição
Índice	Obrigatório	Variantes	O número de índice ou o nome do objeto.

Objeto ModelTableColumn

Represente uma única coluna no objeto ModelTable . Usado ao criar relações programaticamente. A tabela a seguir lista as propriedades do objeto ModelTableColumn .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
DataType	Somente leitura	xlParameterDataType	Retorna o tipo de dados da coluna.
Nome	Somente leitura	String	Retorna o nome do objeto ModelTableColumn .
Responsável	Somente leitura	Object	Retorna um objeto que representa o objeto pai do objeto ModelTableColumn especificado.

Coleção ModelTableNames

A coleção ModelTableNames contém uma coleção de objetos ModelTableName no PPM. A tabela a seguir lista as propriedades da coleção ModelTableNames .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Count	Somente leitura	Long	Retorna o número de objetos ModelTableName na coleção
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai do objeto ModelTableNames especificado.

Método ModelTableNames.Item

Retorna um único objeto da coleção ModelTableNames . A tabela a seguir lista os parâmetros do método Item .

Name	Obrigatório/opcional	Tipo	Descrição
Índice	Obrigatório	Variantes	O número de índice ou o nome do objeto.

Coleção ModelTableNameChanges

A coleção ModelTableNameChanges contém uma coleção de objetos ModelTableNameChange no PPM. A tabela a seguir lista as propriedades da coleção ModelTableNameChanges .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Count	Somente leitura	Long	Retorna o número de objetos ModelTableNameChange na coleção.
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um Objeto que representa o objeto pai da coleção ModelTableNameChanges especificada.

Método ModelTableNameChanges.Item

Retorna um único objeto da coleção ModelTableNameChanges . A tabela a seguir lista os parâmetros do método Item .

Name	Obrigatório/opcional	Tipo	Descrição
Índice	Obrigatório	Variantes	O número de índice ou o nome do objeto.

Objeto ModelTableNameChange

Um objeto que representa o nome antigo e novo de uma tabela que foi renomeada no PPM. A tabela a seguir lista as propriedades do objeto ModelTableNameChange .

Propriedade	Leitura/gravação	Tipo	Descrição
Aplicativo	Somente leitura	Aplicativo	Retorna um objeto que representa o aplicativo Microsoft Excel.
Creator	Somente leitura	xlCreator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Responsável	Somente leitura	Object	Retorna um objeto que representa o modelo em que o objeto ModelTableNameChange reside.
TableNameNew	Somente leitura	String	Retorna o novo nome da tabela.
TableNameOld	Somente leitura	String	Retorna o nome antigo da tabela.

Conclusão

O suplemento do PowerPivot permite que você crie seus próprios cubos em vez de usar os padrões que o Excel cria para você por trás das tabelas do Power. Com esse suplemento, é possível ver os cubos em um contexto visual e alterar propriedades específicas do cubo. O objeto Model armazena referências a conexões de pasta de trabalho e informações sobre as Tabelas e Relações contidas no Modelo do PowerPivot.

Confira também

• Introdução do PowerPivot para Excel Tutorial
• Dados de exemplo do PowerPivot para Excel Tutorial

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.