ArgumentosArguments

'provider_name''provider_name'É uma cadeia de caracteres que representa o nome amigável (ou PROGID) do provedor OLE DB conforme especificado no registro.Is a character string that represents the friendly name (or PROGID) of the OLE DB provider as specified in the registry.provider_name não tem valor padrão.provider_name has no default value.

'datasource''datasource'Uma constante de cadeia de caracteres que corresponder a uma fonte de dados OLE DB específica.Is a string constant that corresponds to a particular OLE DB data source.datasource é a propriedade DBPROP_INIT_DATASOURCE a ser passada para a interface IDBProperties do provedor para inicializar o provedor.datasource is the DBPROP_INIT_DATASOURCE property to be passed to the IDBProperties interface of the provider to initialize the provider.Normalmente, essa cadeia de caracteres inclui o nome do arquivo de banco de dados, o nome de um servidor de banco de dados ou um nome que o provedor entenda para localizar o banco de dados (ou bancos de dados).Typically, this string includes the name of the database file, the name of a database server, or a name that the provider understands to locate the database or databases.

'user_id''user_id'É uma constante de cadeia de caracteres que é o nome de usuário passado para o provedor OLE DB especificado.Is a string constant that is the user name passed to the specified OLE DB provider.user_id especifica o contexto de segurança para a conexão e é passado como a propriedade DBPROP_AUTH_USERID para inicializar o provedor.user_id specifies the security context for the connection and is passed in as the DBPROP_AUTH_USERID property to initialize the provider.user_id não pode ser um nome de logon do Microsoft Windows.user_id cannot be a Microsoft Windows login name.

'password''password'É uma constante de cadeia de caracteres que é a senha de usuário a ser passada para o provedor OLE DB.Is a string constant that is the user password to be passed to the OLE DB provider.password é passada pela propriedade DBPROP_AUTH_PASSWORD ao inicializar o provedor.password is passed in as the DBPROP_AUTH_PASSWORD property when initializing the provider.password não pode ser uma senha do Microsoft Windows.password cannot be a Microsoft Windows password.

Para obter informações sobre como usar a opção BULK, consulte "Comentários", mais adiante neste tópico.For information about how to use the BULK option, see "Remarks," later in this topic.Para obter informações sobre as permissões exigidas pela opção BULK, consulte "Permissões" mais adiante, neste tópico.For information about the permissions that are required by the BULK option, see "Permissions," later in this topic.

Recomendamos a especificação de um nome de ordenação para cada coluna em um arquivo de formato, exceto quando você desejar que a opção 65001 tenha prioridade sobre a especificação de ordenação/página de código.We recommend that you specify a collation name for each column in a format file, except when you want the 65001 option to have priority over the collation/code page specification.

Indica a página de código de origem na qual são codificados os dados de caracteres do arquivo de dados; por exemplo, 850.Indicates the source code page on which the character data in the data file is encoded; for example, 850.

FIRSTROW =first_rowFIRSTROW =first_rowEspecifica o número da primeira linha a carregar.Specifies the number of the first row to load.O padrão é 1.The default is 1.Indica a primeira linha no arquivo de dados especificado.This indicates the first row in the specified data file.Os números de linhas são determinados pela contagem dos terminadores de linha.The row numbers are determined by counting the row terminators.FIRSTROW tem base 1.FIRSTROW is 1-based.

LASTROW =last_rowLASTROW =last_rowEspecifica o número da última linha a ser carregada.Specifies the number of the last row to load.O padrão é 0.The default is 0.Indica a última linha no arquivo de dados especificado.This indicates the last row in the specified data file.

MAXERRORS =maximum_errorsMAXERRORS =maximum_errorsEspecifica o número máximo de erros de sintaxe ou de linhas fora de conformidade, conforme definido no arquivo de formato, que podem ocorrer antes de OPENROWSET lançar uma exceção.Specifies the maximum number of syntax errors or nonconforming rows, as defined in the format file, that can occur before OPENROWSET throws an exception.Até que MAXERRORS seja atingido, OPENROWSET ignora as linhas inválidas, deixando de carregá-las, e as conta como erros.Until MAXERRORS is reached, OPENROWSET ignores each bad row, not loading it, and counts the bad row as one error.

ROWS_PER_BATCH =rows_per_batchROWS_PER_BATCH =rows_per_batchEspecifica o número aproximado de linhas de dados no arquivo de dados.Specifies the approximate number of rows of data in the data file.Este valor deve ser da mesma ordem que o número real de linhas.This value should be of the same order as the actual number of rows.

Ao usar o conjunto de linhas como tabela de origem na cláusula FROM de uma consulta, cujas colunas de classificação e de junção correspondam.Using the rowset as a source table in the FROM clause of a query, where the sort and join columns match.

Se as linhas reais do arquivo de dados não estiverem classificadas na ordem especificada, ou se a dica UNIQUE tiver sido especificada e houver chaves duplicadas, será retornado um erro.If the actual rows in the data file are not sorted according to the order that is specified, or if the UNIQUE hint is specified and duplicates keys are present, an error is returned.

Recomendamos importar apenas os dados XML que usam a opção SINGLE_BLOB, em vez de SINGLE_CLOB e SINGLE_NCLOB, porque só SINGLE_BLOB oferece suporte a todas as conversões de codificação do Windows.We recommend that you import XML data only using the SINGLE_BLOB option, rather than SINGLE_CLOB and SINGLE_NCLOB, because only SINGLE_BLOB supports all Windows encoding conversions.

SINGLE_CLOBSINGLE_CLOBA leitura de data_file como ASCII retorna o conteúdo como um conjunto de linhas de linha e coluna únicas do tipo varchar(max) , usando a ordenação do banco de dados atual.By reading data_file as ASCII, returns the contents as a single-row, single-column rowset of type varchar(max), using the collation of the current database.

SINGLE_NCLOBSINGLE_NCLOBA leitura de data_file como UNICODE retorna o conteúdo como um conjunto de linhas de linha e coluna únicas do tipo nvarchar(max) , usando a ordenação do banco de dados atual.By reading data_file as UNICODE, returns the contents as a single-row, single-column rowset of type nvarchar(max), using the collation of the current database.

No acesso a fontes de dados OLE DB remotas, a identidade de logon das conexões confiáveis não são delegadas automaticamente do servidor no qual o cliente é conectado ao servidor que está sendo consultado.When accessing remote OLE DB data sources, the login identity of trusted connections is not automatically delegated from the server on which the client is connected to the server that is being queried.A delegação de autenticação deve ser configurada.Authentication delegation must be configured.

Qualquer chamada a OPENDATASOURCE, OPENQUERY ou OPENROWSET na cláusula FROM é avaliada separada e independentemente de qualquer chamada a essas funções usadas como o destino da atualização, mesmo se argumentos idênticos forem fornecidos às duas chamadas.Any call to OPENDATASOURCE, OPENQUERY, or OPENROWSET in the FROM clause is evaluated separately and independently from any call to these functions used as the target of the update, even if identical arguments are supplied to the two calls.Em particular, as condições de filtro ou junção aplicadas no resultado de uma dessas chamadas não têm efeito sobre os resultado da outra.In particular, filter or join conditions applied on the result of one of those calls have no effect on the results of the other.

Uma cláusula FROM que é usada com SELECT pode chamar OPENROWSET(BULK...) em vez de um nome de tabela, com funcionalidade completa de SELECT.A FROM clause that is used with SELECT can call OPENROWSET(BULK...) instead of a table name, with full SELECT functionality.

OPENROWSET com a opção BULK exige um nome de correlação, também conhecido como variável ou alias de intervalo, na cláusula FROM.OPENROWSET with the BULK option requires a correlation name, also known as a range variable or alias, in the FROM clause.Podem ser especificados aliases de coluna.Column aliases can be specified.Se uma lista de aliases de coluna não for especificada, o arquivo de formato deverá ter nomes de coluna.If a column alias list is not specified, the format file must have column names.Especificar aliases de coluna faz com que os nomes de coluna sejam substituídos no arquivo de formato; por exemplo:Specifying column aliases overrides the column names in the format file, such as:

FROM OPENROWSET(BULK...) AS table_alias

FROM OPENROWSET(BULK...) AS table_alias(column_alias,...n)

Importante

A falha ao adicionar o AS <table_alias> resultará no erro:Failure to add the AS <table_alias> will result in the error:Mensagem 491, Nível 16, Estado 1, Linha 20Msg 491, Level 16, State 1, Line 20Um nome de correlação deve ser especificado para o conjunto de linhas em massa na cláusula from.A correlation name must be specified for the bulk rowset in the from clause.

O exemplo a seguir seleciona todos os dados da tabela Customers da instância local do banco de dados SQL ServerSQL ServerNorthwind e da tabela Orders do banco de dados Northwind do Access armazenado no mesmo computador.The following example selects all data from the Customers table from the local instance of SQL ServerSQL ServerNorthwind database and from the Orders table from the Access Northwind database stored on the same computer.