Udostępnij za pośrednictwem

  • Artykuł

SQL Server XML luzem obciążenia Model obiektowy (SQLXML 4.0)

Microsoft SQL Server modelu obiektów XML luzem obciążenia składa się z SQLXMLBulkLoad obiektu.Ten obiekt obsługuje następujące metody i właściwości.

Metody

  • Execute
    Luzem ładuje dane przy użyciu pliku schematu i pliku danych (lub strumienia) są dostarczane jako parametry.

Właściwości

  • BulkLoad
    Określa, czy należy przeprowadzić obciążenia luzem.Ta właściwość jest przydatna, jeśli chcesz wygenerować tylko schematy (zobacz SchemaGen, SGDropTables, i SGUseID Właściwości, które należy wykonać) i nie ładowanie zbiorcze.Jest to wartość logiczna właściwość.Gdy właściwość jest zestaw ma wartość TRUE, wykonuje obciążenia luzem XML.Gdy jest zestaw na FALSE, obciążenia luzem XML nie wykonuje.

    Wartością domyślną jest TRUE.

  • CheckConstraints
    Określa, czy ograniczenia (takie jak ograniczenia z powodu klucz podstawowy/ obcego relacji między kolumna klucza), są określone kolumna powinny być sprawdzane podczas obciążenia luzem XML wstawia dane do kolumn.Jest to wartość logiczna właściwość.

    Gdy właściwość jest zestaw ma wartość TRUE, kontrole obciążenia luzem XML (co oznacza, że naruszenie ograniczenia powoduje błąd) dodaje ograniczenia dla każdej wartości.

    Ostrzeżenie

    Aby pozostawić tę właściwość jako FALSE, musisz mieć ALTER TABLE uprawnień do tabel miejsce docelowe.Aby uzyskać więcej informacji, zobacz ALTER TABLE (Transact-SQL).

    Wartością domyślną jest FALSE.Gdy jest zestaw na FALSE, obciążenia luzem XML ignoruje ograniczenia podczas operacji wstawiania.W bieżącej implementacji należy zdefiniować tabele w kolejności od klucz podstawowy i relacje klucz obcy w schemacie mapowania.Oznacza to, że tabela z klucz podstawowy przed należy zdefiniować odpowiedniej tabeli z kluczem obcym; w przeciwnym razie obciążenia luzem XML nie powiedzie się.

    Należy zauważyć, że jeśli czynności propagacji Identyfikatora, a następnie ta opcja nie ma zastosowania i ograniczenia sprawdzanie pozostanie na.Dzieje się podczas KeepIdentity=False i nie ma relacji zdefiniowanych, gdzie nadrzędny jest tożsamość pole i wartość jest podana podrzędność, jak jest on generowany.

  • ConnectionCommand
    Określa istniejący obiekt połączenia (na przykład ADO lub ICommand polecenia obiekt) że powinien obciążenia luzem XML używany.Można użyć ConnectionCommand Właściwość zamiast określania połączenia ciąg z ConnectionString Właściwości.Transaction Właściwość musi być zestaw na wartość TRUE, jeśli używasz ConnectionCommand.

    Jeśli używasz zarówno ConnectionString i ConnectionCommand właściwość obciążenia luzem XML używa ostatniego właściwość określonego.

    Wartością domyślną jest NULL.

  • ConnectionString
    Identyfikuje połączenie OLE DB ciąg , zawiera informacje niezbędne do nawiązania połączenia z wystąpienie bazy danych.Jeśli używasz zarówno ConnectionString i ConnectionCommand właściwość obciążenia luzem XML używa ostatniego właściwość określonego.

    Wartością domyślną jest NULL.

  • ErrorLogFile
    Określa nazwę pliku, w którym obciążenia luzem XML rejestruje błędy i komunikaty.Wartością domyślną jest pusty ciąg, w którym to przypadek nie dochodzi do rejestrowania.

  • FireTriggers
    Określa, jeżeli wyzwalaczy zdefiniowany w tabelach miejsce docelowe powinna ognia podczas operacji ładowania luzem.Wartość domyślna to FALSE.

    Gdy zestaw ma wartość TRUE, wyzwalacze będą ognia na normalny podczas operacji wstawiania.

    Ostrzeżenie

    Aby pozostawić tę właściwość jako FALSE, musisz mieć ALTER TABLE uprawnień do tabel miejsce docelowe.Aby uzyskać więcej informacji, zobacz ALTER TABLE (Transact-SQL).

    Należy zauważyć, że jeśli czynności propagacji Identyfikatora, a następnie ta opcja nie ma zastosowania i wyzwalaczy pozostanie na.Dzieje się podczas KeepIdentity=False i nie ma relacji zdefiniowanych, gdzie nadrzędny jest tożsamość pole i wartość jest podana podrzędność, jak jest on generowany.

  • ForceTableLock
    Określa, czy tabele, do których obciążenia luzem XML kopiuje dane powinny być zablokowana na czas ładowania luzem.Jest to wartość logiczna właściwość.Gdy właściwość jest zestaw ma wartość TRUE, obciążenia luzem XML nabywa blokady tabela na czas ładowania luzem.Gdy ma wartość FALSE, obciążenia luzem XML uzyskuje blokadę tabela każdego czas do wstawienia rekordu w tabela.

    Wartością domyślną jest FALSE.

  • IgnoreDuplicateKeys
    Określa, co należy zrobić w przypadku próby wstawienia zduplikowanych wartości kolumna klucz.Jeśli ta właściwość jest zestaw na wartość TRUE i próby wstawienia rekordu zduplikowanych wartości kolumna klucz SQL Server nie wstawia tego rekordu.Ale go wstawić rekord kolejnych; w ten sposób nie niepowodzenie operacji ładowania luzem.Jeśli ta właściwość jest zestaw false, obciążenia masowych awarii podczas próby wstawienia zduplikowanej wartości kolumna klucz.

    Gdy IgnoreDuplicateKeys właściwość ma wartość TRUE, COMMIT instrukcja wydane dla każdego rekordu, dodaje się w tabela.To spowalnia niedziałający wydajności.zestaw wartość TRUE tylko wtedy, gdy właściwość Transaction właściwość ma wartość FALSE, ponieważ transakcyjne zachowanie jest implementowane przy użyciu plików.

    Wartością domyślną jest FALSE.

  • KeepIdentity
    Określa sposób postępowania z wartości w kolumnie Typ tożsamości źródło pliku.Jest to wartość logiczna właściwość.Kiedy właściwość ma wartość TRUE, obciążenia luzem XML przypisuje wartości, które są określone w źródło pliku do kolumna tożsamości.Kiedy właściwość ma wartość FALSE, operacji ładowania luzem ignoruje wartości kolumna tożsamości, które są określone w źródło.W takim przypadek SQL Server przypisuje wartość z kolumna tożsamości.

    Jeżeli obciążenia luzem obejmuje kolumnie klucz obcego, odnoszące się do kolumna tożsamości w którym SQL Server-wygenerowane wartości są przechowywane, obciążenia luzem odpowiednio propaguje te wartości tożsamości do obcej kolumnę klucz.

    Wartość tej właściwość dotyczy wszystkich kolumn zaangażowanych w ładowanie zbiorcze.Wartością domyślną jest TRUE.

    Ostrzeżenie

    Aby pozostawić tę właściwość jako PRAWDZIWE, musisz mieć ALTER TABLE uprawnień do tabel miejsce docelowe.W przeciwnym razie musi być zestaw na wartość FALSE.Aby uzyskać więcej informacji, zobacz ALTER TABLE (Transact-SQL).

  • KeepNulls
    Określa, jakie wartości dla kolumna, która brakuje odpowiedniego atrybut lub element podrzędność w dokumencie XML.Jest to wartość logiczna właściwość.Gdy właściwość jest zestaw na wartość TRUE, obciążenia luzem XML przypisuje wartości null do kolumna.Go nie przypisuje wartość domyślna kolumna, ewentualne jako zestaw na serwerze.Wartość tej właściwość dotyczy wszystkich kolumn zaangażowanych w ładowanie zbiorcze.

    Wartością domyślną jest FALSE.

  • SchemaGen
    Określa, czy do tworzenia tabel wymagane przed wykonaniem operacji ładowania luzem.Jest to wartość logiczna właściwość.Jeśli ta właściwość jest zestaw ma wartość TRUE, tworzone są tabele, określone w schemacie mapowania (bazy danych muszą istnieć).Jeśli jeden lub więcej tabel już istnieje w bazie danych, SGDropTables właściwość określa, czy istniejące tabele te są opuszczane i utworzony ponownie.

    The default value for the SchemaGen property is FALSE.SchemaGen does not create PRIMARY KEY constraints on the newly created tables.SchemaGen does, however, create FOREIGN KEY constraints in the database if it can find matching sql:relationship and sql:key-fields annotations in the mapping schema and if the key field consists of a single column.

    Należy zauważyć, że jeśli użytkownik zestaw SchemaGen właściwość na wartość TRUE, obciążenia luzem XML wykonuje następujące czynności:

    • Tworzy niezbędne tabele z nazwy elementów i atrybut.Dlatego jest ważne, aby używać SQL Server słów zastrzeżonych nazw elementów i atrybut w schemacie.

    • Zwraca przepełnienie danych dla każdej kolumna, wyznaczona za pomocą sql:overflow-pole w Typ danych xml format.

  • SGDropTables
    Określa, czy istniejące tabele powinny być usunięte i utworzony ponownie.Ta właściwość jest używana podczas SchemaGen właściwość jest zestaw TRUE.Jeśli SGDropTables ma wartość FALSE, istniejące tabele są zachowywane.Gdy ta właściwość ma wartość TRUE, istniejące tabele są usuwane i utworzony ponownie.

    Wartością domyślną jest FALSE.

  • SGUseID
    Określa, czy atrybut w schemacie mapowanie jest zidentyfikowane jako id typu mogą być używane w utworzenie ograniczenia klucza podstawowego, podczas tworzenia tabela.Użyj tej właściwości po SchemaGen właściwość jest zestaw TRUE.Jeśli SGUseID ma wartość PRAWDA, SchemaGen narzędzie używa atrybut dt:type="id" jest określony jako klucz podstawowy kolumna i dodaje odpowiednie klucz podstawowy ograniczenie podczas tworzenia tabela.

    Wartością domyślną jest FALSE.

  • TempFilePath
    Określa ścieżka pliku, gdzie XML ładowanie zbiorcze tworzy pliki tymczasowe dla transakcyjnego ładowanie zbiorcze.(Ta właściwość jest przydatna tylko wtedy, gdy właściwość transakcji jest zestaw na wartość TRUE.) Musi zapewnić, że SQL Server konto używane dla obciążenia luzem XML ma dostęp do tej ścieżka.Jeśli ta właściwość nie jest zestaw, obciążenia luzem XML przechowywane są pliki tymczasowe w lokalizacji określonej w zmiennej środowiskowej TEMP.

  • Transaction
    Określa, czy jako transakcja powinna być dokonywana obciążenia luzem, w którym to przypadek wycofywania jest zagwarantowana Jeśli obciążenia luzem nie powiedzie się.Jest to wartość logiczna właściwość.Jeśli właściwość jest zestaw ma wartość TRUE, obciążenia luzem występuje w kontekście transakcyjnych.TempFilePath Właściwość jest przydatna tylko wtedy, gdy Transaction jest zestaw TRUE.

    Ostrzeżenie

    W przypadku ładowania danych binarnych (takich jak bin.hex, bin.base64 typów danych XML do pliku binarnego, obraz SQL Server typów danych), Transaction właściwość musi być zestaw na FALSE.

    Wartością domyślną jest FALSE.

  • XMLFragment
    Określa, czy źródło danych jest XML fragment.XML fragment jest dokument XML z nie pojedynczego elementu najwyższego poziom (głównym).Jest to wartość logiczna właściwość.Ta właściwość musi być ustawiona na wartość TRUE, jeśli źródło pliku składa się z fragmentu XML.

    Wartością domyślną jest FALSE.