OPENROWSET (Transact-SQL)

Argumenty

• 'provider_name'
  Is a character string that represents the friendly name (or PROGID) of the OLE DB provider as specified in the registry.provider_name has no default value.

• 'datasource'
  Is a string constant that corresponds to a particular OLE DB data source.datasource is the DBPROP_INIT_DATASOURCE property to be passed to the IDBProperties interface of the provider to initialize the provider.Zazwyczaj ten ciąg zawiera nazwę plik bazy danych, nazwę serwera bazy danych lub nazwy, która rozumie, aby zlokalizować bazę danych i baz danych dostawca.

• 'user_id'
  Is a string constant that is the user name passed to the specified OLE DB provider.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 cannot be a Microsoft Windows login name.

• 'password'
  Is a string constant that is the user password to be passed to the OLE DB provider.password is passed in as the DBPROP_AUTH_PASSWORD property when initializing the provider.password cannot be a Microsoft Windows password.

• 'provider_string'
  Is a provider-specific connection string that is passed in as the DBPROP_INIT_PROVIDERSTRING property to initialize the OLE DB provider.provider_string typically encapsulates all the connection information required to initialize the provider.Aby uzyskać listę słów kluczowych, które są rozpoznawane przez SQL Server Macierzysta klient OLE DB, zobacz Inicjowanie i właściwości autoryzacja.

• catalog
  Jest nazwą katalogu lub w którym znajduje się określony obiekt bazy danych.

• schema
  Jest nazwą właściciela schematu lub obiekt, dla określonego obiektu.

• object
  Jest to nazwa obiektu, który unikatowo identyfikuje obiekt, aby pracować.

• 'query'
  Jest stała znakowa przesyłane do i wykonywany przez dostawca.Lokalne wystąpienie SQL Server nie przetwarzają tej kwerendy, ale wyniki zwróconych przez dostawca, kwerenda przekazująca kwerendy procesów. Kwerendy przekazujące są przydatne w przypadku, gdy używany na dostawców, którzy nie należy wprowadzać dostępne ich danych tabelarycznych, za pomocą nazwy tabel, ale tylko za pośrednictwem język poleceń.Kwerendy przekazujące są obsługiwane na serwerze zdalnym, dopóki dostawca kwerendy obsługuje OLE DB Command obiekt i jego obowiązkowe interfejsów. Aby uzyskać więcej informacji zobaczProgram SQL Server Native klient (OLE DB) Reference.

• MASOWE
  Używa dostawca BULK zestawu zestaw wierszy dla OPENROWSET odczytać danych z pliku.W SQL ServerOPENROWSET może odczytać z pliku danych bez ładowania danych do tabela miejsce docelowe. W ten sposób można użyć prostej instrukcja SELECT OPENROWSET.

  Argumenty opcji BULK umożliwia znaczne kontroli nad w przypadku gdy do rozpoczęcia i zakończenia odczytywania danych, jak postępować z błędami i w jaki sposób dane są interpretowane.Na przykład można określić, czy jako pojedynczy wiersz, kolumna pojedynczy zestaw wierszy tego typu można odczytać pliku danych varbinary, varchar, lub nvarchar. To zachowanie domyślne jest opisana w opisy argumentów, które należy wykonać.

  Aby uzyskać informacje na temat korzystania z opcji BULK należy przeczytaj „ Spostrzeżenia w dalszej części tego tematu.Aby uzyskać informacje dotyczące uprawnień, które są wymagane przez opcję BULK zobacz "" uprawnienia"w dalszej części tego tematu.

  Uwaga

  Służy do importowania danych z model pełnego odzyskiwanie, OPENROWSET (BULK...), gdy nie Optymalizacja logowania.

  Aby uzyskać informacje na temat przygotowywania danych do import zbiorczy zobacz Preparing Data for Bulk Export or Import.

• 'data_file'
  Jest to pełna ścieżka pliku danych, których dane są można skopiować do tabela miejsce docelowe.

• FORMATFILE ='format_file_path'
  Specifies the full path of a format file.SQL Server supports two types of format files: Kod XML i -XML.

  plik formatu jest wymagany do definiowania typów kolumn zestaw wyników.Jedynym wyjątkiem jest, gdy określono SINGLE_CLOB, SINGLE_BLOB lub SINGLE_NCLOB; w takim przypadek nie jest wymagany plik formatu.

  Aby uzyskać informacje dotyczące plików w formacie zobacz Using a Format File to Bulk Import Data.

• < bulk_options >
  Określa jeden lub więcej argumentów dla opcji BULK.

• CODEPAGE = { "ACP" | "OEM" | "RAW" | "code_page" }
  Określa strona kodowa danych w pliku danych.CODEPAGE ma znaczenie tylko wtedy, gdy dane zawierają char, varchar, lub text kolumny z wartościami znaku więcej niż 127 lub mniejszy niż 32.

  Uwaga

  Zaleca się, że zostanie podana nazwa sortowanie dla każdej kolumna plik formatu.

  Wartość CODEPAGE	Description
  AKP	Konwertuje kolumn char, varchar, lub text Typ danych z ANSI /Microsoft Strona kodowa systemu Windows (ISO 1252) do SQL Server Strona kodowa.
  OEM (domyślnie)	Konwertuje kolumn char, varchar, lub text Typ danych ze strony kodowej systemu OEM do SQL Server Strona kodowa.
  NIEPRZETWORZONE	Konwersja nie występuje z jednej strona kodowa do innego.Jest to najszybszy opcji.
  code_page	Wskazuje urządzenie źródłowe strona kodową, na które są kodowane danych znakowych w pliku danych, na przykład 850. Important Note: SQL Server nie obsługuje strona kodowa 65001 (kodowania UTF-8).

• ERRORFILE ='file_name'
  Określa plik, który jest używany do zbierania wiersze, które mają błędów formatowania i nie można przekonwertować na zestawie zestaw wierszy OLE DB.Te wiersze są kopiowane do tego pliku błąd z pliku danych „ tak jak jest. „

  Błąd pliku jest tworzony w momencie rozpoczęcia wykonywania polecenia.Błąd będzie można zwiększyć, jeżeli plik już istnieje.Ponadto plik formantu, który ma rozszerzenie. ERROR.txt jest tworzony.Ten plik odwołuje się do każdego wiersza w pliku błędu i zawiera błąd diagnostyki.Po poprawieniu błędów, możliwe jest załadowanie danych.

• FIRSTROW **=**first_row
  Określa numer pierwszego wiersza do załadowania.Wartość domyślna to 1.Oznacza to, w pierwszym wierszu pliku danych określone.Numery wierszy są określane przez zliczania terminatory wiersza.FIRSTROW jest oparte na 1.

• LASTROW **=**last_row
  Określa ostatni wiersz do załadowania.Wartość domyślna to 0.Określa ostatni wiersz w pliku określone dane.

• MAXERRORS **=**maximum_errors
  Określa maksymalną liczbę błędów składniowych lub niezgodne wiersze zdefiniowane w pliku formatu, który może wystąpić, zanim OPENROWSET zgłasza wyjątek.Aż do osiągnięcia MAXERRORS OPENROWSET ignoruje każdy Zły wiersz nie załadować go i liczby Zły wiersz jako jeden błąd.

  Wartość domyślna dla maximum_errors wynosi 10.

  Uwaga

  MAX_ERRORS nie ma zastosowania do ograniczeń CHECK lub do konwersji money i bigint typy danych.

• ROWS_PER_BATCH **=**rows_per_batch
  Określa przybliżoną liczbę wierszy danych w pliku danych.Wartość ta powinna być o takiej samej kolejności, jak rzeczywista liczba wierszy.

  OPENROWSET zawsze importuje plik danych w jednej partia.Niemniej jednak jeśli określony rows_per_batch wartość > 0, procesor kwerend używa wartości rows_per_batch jako wskazówkę dla alokacji zasobów w planie kwerendy.

  Domyślnie ROWS_PER_BATCH jest nieznany.Określanie ROWS_PER_BATCH = 0 jest taka sama, jak pominięcie ROWS_PER_BATCH.

• ORDER ({column [ASC | DESC]} [ ,... n ] [UNIKATOWY])
  Wskazówka opcjonalny, określający, w jaki sposób dane w pliku danych są sortowane.Domyślnie operacja zbiorcza zakłada się, plik danych jest nieuporządkowana.Wydajność może wzrosnąć, jeśli w określonej kolejności może być wykorzystana przez optymalizator kwerendy, aby wygenerować bardziej efektywny plan kwerend.Następujące przykłady podczas określania sortowania może być korzystne:

  • Wstawianie zestaw wierszy do tabela, która ma indeks klastrowany, gdzie dane zestawu zestaw wierszy są sortowane w kluczu indeksu klastrowanego.

  • Przyłączanie się do zestawu zestaw wierszy z inną tabelą, w których odpowiadają kolumny sortowania i łączyć.

  • Agregowania danych zestawu zestaw wierszy przez sortowanie kolumn.

  • Za pomocą zestawu zestaw wierszy w tabela źródłowej w klauzula FROM kwerendy, których kolumny sortowania i łączyć odpowiadają.

  Unikatowa Określa, że plik danych nie ma zduplikowane wpisy.

  Jeśli rzeczywista wierszy w pliku danych nie są posortowane w kolejności określonej lub UNIQUE wskazówka jest określony i występują duplikaty kluczy, zwracany jest błąd.

  Aliasy kolumna są wymagane, gdy używany jest ORDER.Lista alias kolumna musi odwoływać się do tabela pochodnej, która jest uzyskiwany za pomocą klauzula BULK.Nazwy kolumn, które są określone w klauzula ORDER odnoszą się do tej listy alias kolumna.(Typy) duża wartośćvarchar(max), nvarchar(max), varbinary(max), a xml) i typy dużych obiektów (LOB) ()text, ntext, a image) nie może być określone kolumny.

• SINGLE_BLOB
  Zwraca zawartość data_file jako pojedynczy wiersz, kolumna pojedynczy zestaw wierszy typu varbinary(max).

  Important Note:
  Firma Microsoft zaleca, aby importować dane XML tylko przy użyciu opcji SINGLE_BLOB zamiast SINGLE_CLOB i SINGLE_NCLOB, ponieważ tylko SINGLE_BLOB obsługuje wszystkie Windows kodowania podczas konwersji.

• SINGLE_CLOB
  Czytając data_file jako ASCII, zwraca zawartość jako jedno wiersz, jedno-kolumna zestawu zestaw wierszy typu varchar(max), za pomocą sortowanie bieżącej bazy danych.

• SINGLE_NCLOB
  Czytając data_file jako UNICODE zwraca zawartość w postaci zestawu zestaw wierszy jednego wiersza, jedną kolumną typu nvarchar(max), za pomocą sortowanie bieżącej bazy danych.

Remarks

OPENROWSET może służyć do uzyskiwania dostępu do dane zdalne danych do DB OLE źródeł tylko wtedy, gdy DisallowAdhocAccess rejestru Opcja jawnie jest ustawiona na 0 dla określonego dostawca i włączeniu opcji konfiguracja zaawansowanej ad Hoc Distributed Queries.Jeśli opcje te nie są skonfigurowane, zachowanie domyślne nie zezwala na dostęp ad hoc.

Dostęp do zdalnych źródeł danych OLE DB, tożsamość logowania zaufanego połączenia nie jest automatycznie delegowane z serwera, na którym klient jest podłączony do serwera, na którym jest poszukiwanych.Delegowanie uwierzytelnianie muszą być skonfigurowane.Aby uzyskać więcej informacji zobaczConfiguring Linked Servers for Delegation.

Nazwy katalogu i schematu są wymagane, jeśli dostawca OLE DB obsługuje wielu katalogów i schematy w określonych danych urządzenie źródłowe.Wartości dla catalog i schema można pominąć, jeśli dostawca OLE DB nie obsługuje ich. Jeśli dostawca obsługuje tylko schematu nazwy, nazwa dwóch części formularza schema**.** object musi być określona.Jeśli dostawca obsługuje tylko katalog nazwy, Nazwa trzech części formularza catalog**.** schema**.**object musi być określona.Trzy części nazwy muszą być określone dla kwerendy przekazujące, które za pomocą SQL Server Macierzystego dostawca klient OLE DB. Aby uzyskać więcej informacji zobaczTransact-SQL Syntax Conventions (Transact-SQL).

OPENROWSET nie akceptuje zmienne dla jej argumentów.

Korzystanie z opcji BULK OPENROWSET

Uprawnienia

OPENROWSET uprawnienia są określane za pomocą uprawnień do nazwy użytkownika, który jest przekazywany do dostawca OLE DB.Aby skorzystać z opcji BULK wymaga uprawnienia ADMINISTROWANIA BULK operacje.

Przykłady

A.Za pomocą OPENROWSET z SELECT i SQL Server Native klient OLE DB dostawca

SELECT a.*
FROM OPENROWSET('SQLNCLI', 'Server=Seattle1;Trusted_Connection=yes;',
     'SELECT GroupName, Name, DepartmentID
      FROM AdventureWorks.HumanResources.Department
      ORDER BY GroupName, Name') AS a;

B.Przy użyciu dostawca Microsoft OLE DB dla aparatu Jet

SELECT CustomerID, CompanyName
   FROM OPENROWSET('Microsoft.Jet.OLEDB.4.0',
      'C:\Program Files\Microsoft Office\OFFICE11\SAMPLES\Northwind.mdb';
      'admin';'',Customers)
GO

C.Za pomocą OPENROWSET i innej tabela w operacji łączyć wewnętrzne

USE Northwind  
GO
SELECT c.*, o.*
FROM Northwind.dbo.Customers AS c 
   INNER JOIN OPENROWSET('Microsoft.Jet.OLEDB.4.0', 
   'C:\Program Files\Microsoft Office\OFFICE11\SAMPLES\Northwind.mdb';'admin';'', Orders)    
   AS o 
   ON c.CustomerID = o.CustomerID 
GO

D.Za pomocą OPENROWSET zbiorczej wstawiania pliku danych do kolumna varbinary(max)

USE AdventureWorks
GO
CREATE TABLE myTable(FileName nvarchar(60), 
  FileType nvarchar(60), Document varbinary(max))
GO

INSERT INTO myTable(FileName, FileType, Document) 
   SELECT 'Text1.txt' AS FileName, 
      '.txt' AS FileType, 
      * FROM OPENROWSET(BULK N'C:\Text1.txt', SINGLE_BLOB) AS Document
GO

E.Za pomocą dostawca OPENROWSET BULK przy użyciu formatu pliku do pobrania wierszy z pliku tekstowego

1     Data Item 1
2     Data Item 2
3     Data Item 3

9.0
2
1  SQLCHAR  0  10 "\t"        1  ID                SQL_Latin1_General_Cp437_BIN
2  SQLCHAR  0  40 "\r\n"      2  Description        SQL_Latin1_General_Cp437_BIN

SELECT a.* FROM OPENROWSET( BULK 'c:\test\values.txt', 
   FORMATFILE = 'c:\test\values.fmt') AS a;

Dodatkowe przykłady

Historia zmian

See Also

Reference

Other Resources