KOPYALA (Transact-SQL)

Şunlar için geçerlidir: Azure Synapse Analytics

Tip

Microsoft Fabric Data Warehouse geleceğe hazır mimariye, yerleşik yapay zekaya ve yeni özelliklere sahip data lake foundation üzerinde kurumsal ölçekli ilişkisel bir ambardır. Veri ambarı konusunda yeniyseniz Fabric Data Warehouse ile başlayın. Mevcut özel SQL havuzu iş yükleri, veri bilimi, gerçek zamanlı analiz ve raporlama alanlarında yeni özelliklere erişmek için Fabric'e yükseltilebilir.

• Fabric ücretsiz deneme başlatın.
• Fabric Veri Ambarı için Taşıma Asistanı

Bu makalede, dış depolama hesaplarından veri yüklemek için Azure Synapse Analytics'da COPY deyiminin nasıl kullanılacağı açıklanmaktadır. Bu açıklama COPY , Azure Synapse Analytics'e yüksek verimlilikte veri alımı için en fazla esnekliği sağlar.

Note

Microsoft Fabric'deki Ambar için bkz. COPY INTO.

Aşağıdaki yetenekler için kullanım COPY :

• Veri ambarı üzerinde katı CONTROL izinlerine gerek kalmadan verileri yüklemek için daha düşük ayrıcalıklı kullanıcılar kullanın.
• Başka bir veritabanı nesnesi oluşturmak zorunda kalmadan tek bir T-SQL deyimi yürütür.
• Sınırlayıcıların (dize, alan, satır) dizeyle ayrılmış sütunlar içinde kaçtığı CSV dosyalarını düzgün ayrıştırma ve yükleme.
• Paylaşılan Erişim İmzaları (SAS) kullanarak depolama hesabı anahtarlarını göstermeden daha ince bir izin modeli belirtin.
• Konum için ERRORFILE farklı bir depolama hesabı kullanın (REJECTED_ROW_LOCATION).
• Her hedef sütun için varsayılan değerleri özelleştirin ve belirli hedef sütunlara yüklenecek kaynak veri alanlarını belirtin.
• CSV dosyaları için özel bir satır sonlayıcı, alan sonlandırıcı ve alan tırnakı belirtin.
• CSV dosyaları için SQL Server Tarih biçimlerini kullanın.
• Depolama konumu yolunda joker karakterler ve birden çok dosya belirtin.
• Otomatik şema bulma, kaynak verileri tanımlama ve hedef tablolara eşleme işlemini basitleştirir.
• Otomatik tablo oluşturma işlemi tabloları otomatik olarak oluşturur ve otomatik şema bulma işlemiyle birlikte çalışır.
• Haritalar ve Listeler gibi Parquet dosyalarından karmaşık veri türlerini, verileri önceden işlemek için başka araçlar kullanmadan doğrudan dize sütunlarına yükleyin.

Note

Parquet dosyalarından karmaşık veri türlerini yüklemek için kullanarak AUTO_CREATE_TABLEotomatik tablo oluşturmayı açın.

deyimini COPY kullanan kapsamlı örnekler ve hızlı başlangıçlar için bkz:

• Hızlı Başlangıç: COPY deyimini kullanarak verileri toplu yükleme
• Hızlı Başlangıç: COPY deyimini ve desteklenen kimlik doğrulama yöntemlerini kullanan örnekler
• Hızlı Başlangıç: Zengin Synapse Studio kullanıcı arabirimini kullanarak COPY deyimini oluşturma

Note

Microsoft Entra ID daha önce Azure Active Directory (Azure AD) olarak biliniyordu.

Syntax

COPY INTO [ schema. ] table_name
[ (Column_list) ]
FROM '<external_location>' [ , ...n ]
WITH
 (
 [ FILE_TYPE = { 'CSV' | 'PARQUET' | 'ORC' } ]
 [ , FILE_FORMAT = EXTERNAL FILE FORMAT OBJECT ]
 [ , CREDENTIAL = (AZURE CREDENTIAL) ]
 [ , ERRORFILE = ' [ http(s)://storageaccount/container ] /errorfile_directory [ / ] ] '
 [ , ERRORFILE_CREDENTIAL = (AZURE CREDENTIAL) ]
 [ , MAXERRORS = max_errors ]
 [ , COMPRESSION = { 'Gzip' | 'DefaultCodec' | 'Snappy' } ]
 [ , FIELDQUOTE = 'string_delimiter' ]
 [ , FIELDTERMINATOR =  'field_terminator' ]
 [ , ROWTERMINATOR = 'row_terminator' ]
 [ , FIRSTROW = first_row ]
 [ , DATEFORMAT = 'date_format' ]
 [ , ENCODING = { 'UTF8' | 'UTF16' } ]
 [ , IDENTITY_INSERT = { 'ON' | 'OFF' } ]
 [ , AUTO_CREATE_TABLE = { 'ON' | 'OFF' } ]
)

Arguments

schema_name

İşlemi gerçekleştiren kullanıcının varsayılan şeması belirtilen tablonun şemasıysa isteğe bağlı. Şema belirtmezseniz ve işlemi gerçekleştiren COPY kullanıcının varsayılan şeması belirtilen tablonun şemasından farklıysa, COPY işlem iptal edilir ve bir hata iletisi döndürülür.

tablo_adı

Verileri kopyalanacak tablonun adı. Hedef tablo geçici veya kalıcı bir tablo olabilir ve veritabanında zaten mevcut olmalıdır. Otomatik şema algılama modu için sütun listesi sağlamayın.

(column_list)

Kaynak veri alanlarını verileri yüklemek için hedef tablo sütunlarına eşlemek için kullanılan bir veya daha fazla sütunun isteğe bağlı listesi.

zaman AUTO_CREATE_TABLE = 'ON' belirtmeyin.

column_list ayraç içine alınmalı ve virgülle sınırlandırılmalıdır. Sütun listesi aşağıdaki biçimdedir:

[(Column_name [varsayılan Default_value] [Field_number] [,... n])]

• Column_name - Hedef tablodaki sütunun adı.
• Default_value - giriş dosyasındaki herhangi bir NULL değerin yerini alan varsayılan değerdir. Varsayılan değer tüm dosya biçimleri için geçerlidir. COPY, sütun listesinden bir sütun atlandığında veya boş bir giriş dosyası alanı olduğunda giriş dosyasından NULL yüklemeyi dener. Varsayılan değer 'default' anahtar sözcüğünden önce
• Field_number - Hedef sütuna eşlenen giriş dosyası alan numarası.
• Alan dizin oluşturma 1'de başlar.

Sütun listesi belirtmediğinizde, COPY sütunları kaynak ve hedef sırasına göre eşler: Giriş alanı 1 hedef sütun 1'e, alan 2 sütun 2'ye gider vb.

Dış konumlar

Verileri içeren dosyaların hazırlandığı konum. Şu anda Azure Data Lake Storage (ADLS) 2. Nesil ve Azure Blob Depolama desteklenmektedir:

• Blob Depolama için dış konum :
• ADLS 2. Nesil: için dış konum

Note

Uç .blob nokta ADLS 2. Nesil için de kullanılabilir ve şu anda en iyi performansı verir. .blob Kimlik doğrulama yönteminiz için gerekli olmadığında uç noktayı .dfs kullanın.

• Hesabı - Depolama hesabı adı

• Kapsayıcı - Blob kapsayıcı adı

• Yol - verilerin klasörü veya dosya yolu. Konum kapsayıcıdan başlar. Bir klasör belirtirseniz, COPY klasördeki tüm dosyaları ve tüm alt klasörlerini alır. COPY gizli klasörleri yoksayar ve yolda açıkça belirtilmediği sürece bir alt çizgi (_) veya nokta (.) ile başlayan dosyaları döndürmez. Bu davranış, joker karakter içeren bir yol belirtirken bile aynıdır.

Şu yollara joker karakterler ekleyebilirsiniz:

• Joker karakter yol adı eşleştirme büyük/küçük harfe duyarlıdır
• Ters eğik çizgi karakterini (\) kullanarak joker karakterden kaçabilirsiniz
• Joker karakter genişletmesi özyinelemeli olarak uygulanır. Örneğin, altındaki Customer1 tüm CSV dosyaları (alt dizinleri Customer1dahil) aşağıdaki örnekte yüklenir: Account/Container/Customer1/*.csv

Note

En iyi performans için, daha fazla sayıda dosya üzerinde genişleyen joker karakterler belirtmekten kaçının. Mümkünse joker karakter belirtmek yerine birden çok dosya konumunu listeleyin.

Birden çok dosya konumunu yalnızca aynı depolama hesabından ve kapsayıcısından virgülle ayrılmış bir liste aracılığıyla belirtebilirsiniz:

• https://<account>.blob.core.windows.net/<container\>/<path\>, https://<account\>.blob.core.windows.net/<container\>/<path\>

FILE_TYPE = { 'CSV' | 'PARQUET' | 'ORC' }

FILE_TYPE dış verilerin biçimini belirtir.

• CSV: RFC 4180 standardıyla uyumlu bir virgülle ayrılmış değerler dosyası belirtir.
• PARQUET: Parquet biçimini belirtir.
• ORC: İyileştirilmiş Satır Sütunlu (ORC) biçimini belirtir.

Note

PolyBase'deki 'Sınırlandırılmış Metin' dosya türü , 'CSV' dosya biçimiyle değiştirilir. Varsayılan virgül sınırlayıcısını FIELDTERMINATOR parametresi aracılığıyla yapılandırabilirsiniz.

FILE_FORMAT = external_file_format_name

FILE_FORMAT yalnızca Parquet ve ORC dosyaları için geçerlidir. Dış veriler için dosya türünü ve sıkıştırma yöntemini depolayan dış dosya biçimi nesnesinin adını belirtir. Dış dosya biçimi oluşturmak için CREATE EXTERNAL FILE FORMATkullanın.

CREDENTIAL (IDENTITY = '', SECRET = '')

CREDENTIAL Dış depolama hesabına erişmek için kimlik doğrulama mekanizmasını belirtir. Kimlik doğrulama yöntemleri şunlardır:

	CSV	Parquet	ORC
Azure Blob Depolama	SAS/MSI/HIZMET SORUMLUSU/ANAHTAR/Entra	SAS/KEY	SAS/KEY
Azure Data Lake 2. Nesil	SAS/MSI/HIZMET SORUMLUSU/ANAHTAR/Entra	SAS (blob 1 )/MSI (dfs 2 )/HİzMET SORUMLUSU/ANAHTAR/Entra	SAS (blob 1 )/MSI (dfs 2 )/HİzMET SORUMLUSU/ANAHTAR/Entra

¹ Bu kimlik doğrulama yöntemi için dış konum yolunuzdaki blob uç noktası (.blob.core.windows.net) gereklidir.

² Bu kimlik doğrulama yöntemi için dış konum yolunuzdaki dfs uç noktası (.dfs.core.windows.net) gereklidir.

Note

• Microsoft Entra ID veya genel depolama hesabı kullanarak kimlik doğrulaması yaparken CREDENTIAL belirtmeniz gerekmez.
• Depolama hesabınız bir sanal ağ ile ilişkiliyse, yönetilen kimlik kullanarak kimlik doğrulaması yapmanız gerekir.

• Paylaşılan Erişim İmzalarıyla (SAS) Kimlik Doğrulaması

  • IDENTITY: Değeri olan bir sabit Shared Access Signature
  • SECRET: Paylaşılan erişim imzası , depolama hesabınızdaki kaynaklara temsilci erişimi sağlar.

• Gereken en düşük izinler: OKUMA ve LİSTE

• Hizmet Sorumlularıyla kimlik doğrulaması

  • IDENTITY: <ClientID>@<OAuth_2.0_Token_EndPoint>
  • SECRET: Microsoft Entra uygulama hizmet sorumlusu anahtarı

• Gereken en düşük RBAC rolleri: Depolama blob verileri katkıda bulunanı, Depolama blob verileri katkıda bulunanı, Depolama blobu veri sahibi veya Depolama blob veri okuyucusu

• Depolama hesabı anahtarıyla kimlik doğrulaması

  • IDENTITY: Değeri olan bir sabit Storage Account Key
  • SECRET: Depolama hesabı anahtarı

• Yönetilen Kimlik (VNet Hizmet Uç Noktaları) ile kimlik doğrulaması

  • IDENTITY: Değeri olan bir sabit Managed Identity

• Gereken en düşük RBAC rolleri: Azure'de Microsoft Entra kayıtlı mantıksal sunucusu için depolama blobu veri katkıda bulunanı veya Depolama blobu veri sahibi. Synapse Çalışma Alanı ile ilişkilendirilmeyen ayrılmış bir SQL havuzu (eski adı SQL DW) kullanılırken bu RBAC rolü gerekli değildir, ancak yönetilen kimlik, kaynak dosyalara okuma erişimini etkinleştirmek için hedef nesnelerde Access Control Listesi (ACL) izinleri gerektirir.

• Microsoft Entra kullanıcısıyla kimlik doğrulaması

  • KIMLIK BILGISI gerekli değil

• Gereken en düşük RBAC rolleri: Microsoft Entra kullanıcısı için depolama blob verileri katkıda bulunanı veya Depolama blobu veri sahibi

ERRORFILE = Dizin Konumu

ERRORFILE yalnızca CSV için geçerlidir. Reddedilen satırların ve karşılık gelen hata dosyasının yazıldığı deyimi içindeki dizini COPY belirtir. Depolama hesabından tam yolu veya kapsayıcıya göre yolu belirtebilirsiniz. Belirtilen yol yoksa ambar bir yol oluşturur. adlı _rejectedrowsbir alt dizin oluşturulur. karakteri, _ konum parametresinde açıkça adlandırılmadığı sürece dizinin diğer veri işleme için kaçış olmasını sağlar.

Note

öğesine ERRORFILEgöreli bir yol geçirdiğinizde, bunu external_location belirttiğiniz kapsayıcı yoluna göre yapın.

Bu dizinde, ambar biçimindeki YearMonthDay -HourMinuteSecond yük gönderme zamanına göre bir klasör oluşturur (örneğin, 20180330-173205). Bu klasörde, işlem iki tür dosya yazar: neden (hata) dosyası ve veri (satır) dosyası. Her dosya, , distributionIDve bir dosya GUID'sinin queryIDbaşına ekler. Veriler ve nedeni ayrı dosyalarda olduğundan, ilgili dosyaların eşleşen bir ön eki vardır.

Depolama hesabının tam yolu tanımlanmışsa ERRORFILE , COPY bu depolamaya bağlanmak için kullanır ERRORFILE_CREDENTIAL . Aksi takdirde, için CREDENTIALbelirttiğiniz değeri kullanır. Kaynak veriler ve ERRORFILEiçin aynı kimlik bilgilerini kullandığınızda, için geçerli ERRORFILE_CREDENTIAL olan kısıtlamalar da geçerlidir.

ERRORFILE_CREDENTIAL = (IDENTITY = '', SECRET = '')

ERRORFILE_CREDENTIAL yalnızca CSV dosyaları için geçerlidir. Desteklenen veri kaynağı ve kimlik doğrulama yöntemleri şunlardır:

• Azure Blob Depolama: SAS, hizmet sorumlusu veya Microsoft Entra

• Azure Data Lake 2. Nesil: SAS, MSI, hizmet sorumlusu veya Microsoft Entra

• Paylaşılan Erişim İmzalarıyla (SAS) Kimlik Doğrulaması

  • IDENTITY: Değeri olan bir sabit Shared Access Signature
  • SECRET: Paylaşılan erişim imzası , depolama hesabınızdaki kaynaklara temsilci erişimi sağlar.

• Gereken en düşük izinler: READ, LIST, WRITE, CREATE, DELETE

• Hizmet Sorumlularıyla kimlik doğrulaması

  • IDENTITY: <ClientID>@<OAuth_2.0_Token_EndPoint>
  • SECRET: Microsoft Entra uygulama hizmet sorumlusu anahtarı

• Gereken en düşük RBAC rolleri: Depolama blob verileri katkıda bulunanı veya Depolama blobu veri sahibi

Note

V1 OAuth 2.0 belirteç uç noktasını kullanma

• Yönetilen Kimlik (VNet Hizmet Uç Noktaları) ile kimlik doğrulaması

  • IDENTITY: Değeri olan bir sabit Managed Identity

• Gereken en düşük RBAC rolleri: Microsoft Entra kayıtlı SQL Veritabanı sunucusu için depolama blobu veri katkıda bulunanı veya Depolama blobu veri sahibi

• Microsoft Entra kullanıcısıyla kimlik doğrulaması

  • CREDENTIAL gerekli değil

• Gereken en düşük RBAC rolleri: Microsoft Entra kullanıcısı için depolama blob verileri katkıda bulunanı veya Depolama blobu veri sahibi

ile ERRORFILE_CREDENTIAL depolama hesabı anahtarı kullanılması desteklenmez.

Note

Hata dosyanız için aynı depolama hesabını kullanır ve kapsayıcının ERRORFILE köküne göre yolu belirtirseniz, değerini belirtmeniz ERROR_CREDENTIALgerekmez.

MAXERRORS = max_errors

MAXERRORS COPY işlemi başarısız olmadan önce yükte izin verilen en fazla reddetme satırı sayısını belirtir. COPY işleminin içeri aktaramadıklarından her satır yoksayılır ve tek bir hata olarak sayılır. En fazla hata sayısı için bir değer belirtmezseniz, varsayılan değer olur 0.

MAXERRORS ile AUTO_CREATE_TABLEkullanılamaz.

olduğundaFILE_TYPE, veri türü dönüştürme hatalarından kaynaklanan özel durumlar (örneğin, Parquet ikiliden SQL tamsayısına) yine de yok sayılarak başarısız olmaya devam eder COPY INTOMAXERRORS.PARQUET

COMPRESSION = { 'DefaultCodec ' | 'Snappy' | 'GZIP' | 'NONE'}

COMPRESSION isteğe bağlıdır ve dış veriler için veri sıkıştırma yöntemini belirtir.

• CSV, GZIP'i destekler.
• Parquet, GZIP ve Snappy'i destekler.
• ORC, DefaultCodec ve Snappy'i destekler.
• Zlib, ORC için varsayılan sıkıştırmadır.

COPY komutu, bu parametreyi belirtmediğinizde dosya uzantısına göre sıkıştırma türünü otomatik olarak algılar:

• .gz - GZİP
• .snappy - Çabuk
• .deflate - DefaultCodec (yalnızca Parquet ve ORC)

COPY komutu, gzip dosyalarının normal şekilde çalışması için sondaki çöpleri içermesini gerektirir. gzip biçimi, dosyaların öncesinde, arasında veya sonrasında ek bilgi olmadan geçerli üyelerden oluşmasını kesinlikle gerektirir. Gzip olmayan verilerin varlığı gibi bu biçimden herhangi bir sapma COPY komutunun başarısızlığına neden olur. COPY'nin başarıyla çalıştığından emin olmak için gzip dosyalarının sonunda sondaki çöplerin olmadığından emin olun.

FIELDQUOTE = 'field_quote'

FIELDQUOTE CSV için geçerlidir ve CSV dosyasında tırnak karakteri (dize sınırlayıcısı) olarak kullanılan tek bir karakteri belirtir. Bu değeri belirtmezseniz, RFC 4180 standardında tanımlandığı gibi tırnak karakteri (") kullanılır. onaltılık gösterimi de için FIELDQUOTEdesteklenir. genişletilmiş ASCII ve çok baytlı karakterler için FIELDQUOTEUTF-8 ile desteklenmez.

Note

FIELDQUOTE karakterleri, çift FIELDQUOTE (sınırlayıcı) varlığının bulunduğu dize sütunlarında kaçış olarak kullanılır.

FIELDTERMINATOR = 'field_terminator'

FIELDTERMINATOR yalnızca CSV için geçerlidir. CSV dosyasında kullanılan alan sonlandırıcısını belirtir. Alan sonlandırıcısını onaltılık gösterimi kullanarak belirtebilirsiniz. Alan sonlandırıcısı çok karakterli olabilir. Varsayılan alan sonlandırıcısı bir (,). genişletilmiş ASCII ve çok baytlı karakterler için FIELDTERMINATORUTF-8 ile desteklenmez.

ROWTERMINATOR = 'row_terminator'

ROWTERMINATOR yalnızca CSV için geçerlidir. CSV dosyasında kullanılan satır sonlandırıcısını belirtir. Onaltılık gösterimi kullanarak satır sonlandırıcısını belirtebilirsiniz. Satır sonlandırıcısı çok karakterli olabilir. Varsayılan olarak, satır sonlandırıcısı \r\n.

COPY komutu, \rile sonuçlanacak \n (yeni satır) belirtirken \r\n karakterine ön ek ekler. Yalnızca \n karakteri belirtmek için onaltılık gösterimi (0x0A) kullanın. Çok karakterli satır sonlandırıcılarını onaltılık olarak belirtirken, her karakter arasında belirtmeyin 0x .

genişletilmiş ASCII ve çok baytlı karakterler için ROWTERMINATORUTF-8 ile desteklenmez.

FIRSTROW = First_row_int

FIRSTROW CSV için geçerlidir ve COPY komutu için tüm dosyalarda ilk okunan satır numarasını belirtir. Değerler, varsayılan değer olan değerinden 1başlar. değerini 2olarak ayarlarsanız, veriler yüklendiğinde her dosyadaki ilk satır (üst bilgi satırı) atlanır. Satır sonlandırıcılarının varlığına bağlı olarak satırlar atlanır.

DATEFORMAT = { 'mdy' | 'dmy' | 'ymd' | 'ydm' | 'myd' | 'dym' }

DATEFORMAT yalnızca CSV için geçerlidir ve SQL Server tarih biçimlerine eşleme tarihi biçimini belirtir. Tüm Transact-SQL tarih ve saat veri türlerine ve işlevlerine genel bakış için bkz. Tarih ve Saat Veri Türleri ve İşlevleri (Transact-SQL). COPY komutundaki DATEFORMAT,oturum düzeyinde yapılandırılmış DATEFORMAT'den önceliklidir.

KODLAMA = 'UTF8' | 'UTF16'

ENCODING yalnızca CSV için geçerlidir. Varsayılan değer UTF8'dir. COPY komutu tarafından yüklenen dosyalar için veri kodlama standardını belirtir.

IDENTITY_INSERT = 'ON' | 'KAPALI'

IDENTITY_INSERT , içeri aktarılan veri dosyasındaki kimlik değerinin veya değerlerinin kimlik sütunu için kullanılıp kullanılmayacağını belirtir. (varsayılan) ise IDENTITY_INSERTOFF , bu sütunun kimlik değerleri doğrulanır, ancak içeri aktarılmaz. COPY komutuyla aşağıdaki davranışa dikkat edin:

• OFF IDENTITY_INSERT ise ve tabloda bir kimlik sütunu varsa
  • Giriş alanını kimlik sütunuyla eşlemeyen bir sütun listesi belirtmelisiniz.
• AÇıKsa ve tabloda bir kimlik sütunu varsa IDENTITY_INSERT
  • Sütun listesini geçirirseniz, bir giriş alanını kimlik sütununa eşlemesi gerekir.
• Varsayılan değer, sütun listesindeki IDENTITY sütunu için desteklenmez.
• Aynı anda yalnızca bir tablo için ayarlayabilirsiniz IDENTITY_INSERT .

Azure Synapse Analytics, tablo oluşturma sırasında belirtilen tohum ve artım değerlerine göre otomatik olarak benzersiz değerler atar.

AUTO_CREATE_TABLE = { 'ON' | 'OFF' }

AUTO_CREATE_TABLE , otomatik şema bulma ile birlikte çalışarak tablonun otomatik olarak oluşturulup oluşturulamadığını belirtir. AUTO_CREATE_TABLE yalnızca Azure Synapse Analytics'daki Parquet dosyaları için kullanılabilir.

• ON: Otomatik tablo oluşturmayı etkinleştirir. İşlem COPY INTO , yüklenecek dosyanın yapısını bularak otomatik olarak yeni bir tablo oluşturur. Parquet dosyalarının otomatik şema keşfinden yararlanmak için bunu önceden var olan tablolarla da kullanabilirsiniz.
• KAPALI: Otomatik tablo oluşturma etkin değil. Default.

Note

Otomatik tablo oluşturma, otomatik şema bulma ile birlikte çalışır. Otomatik tablo oluşturma varsayılan olarak etkin değildir.

Permissions

COPY komutunu çalıştıran kullanıcının aşağıdaki izinlere sahip olması gerekir:

• VERITABANı TOPLU İŞLEMLERINI YÖNETME
• INSERT

INSERT ve ADMINISTER BULK OPERATIONS izinleri gerektirir. Azure Synapse Analytics'te INSERT ve ADMINISTER DATABASE BULK OPERATIONS izinleri gereklidir.

Ayrıca COPY komutunu yürüten kullanıcı da yeni bir tablo oluşturmayı ve içine veri yüklemeyi planlıyorsa CREATE TABLE ve ALTER ON SCHEMA izinleri gerektirir.

Örneğin, mike@contoso.comHR şemasında yeni bir tablo oluşturmak ve bir Parquet dosyasından veri eklemek için COPY kullanmasına izin vermek için aşağıdaki Transact-SQL örneğini kullanın:

GRANT ADMINISTER DATABASE BULK OPERATIONS to [mike@contoso.com];
GRANT INSERT to [mike@contoso.com];

GRANT CREATE TABLE to [mike@contoso.com];
GRANT ALTER on SCHEMA::HR to [mike@contoso.com];

Remarks

Bu COPY ifade, satır verileri ve komut parametreleri için yalnızca UTF-8 ve UTF-16 geçerli karakterleri kabul eder. Deyimi, COPY geçersiz karakterler kullanan ve veri bozulması veya diğer hatalar gibi beklenmeyen sonuçlara neden olan kaynak dosyaları veya parametreleri (veya ROWTERMINATORFIELDTERMINATORgibi) yanlış yorumlayabilir. Kaynak dosyalarınızın ve parametrelerinizin UTF-8 veya UTF-16 uyumlu olduğundan emin olun, ifadeyi COPY çağırmadan önce.

Sorgu MAXDOP ipucu ile COPY INTOdesteklenmez.

Güvenilir yürütmeyi sağlamak için işlem sırasında kaynak dosya ve klasörleri değiştirmeyin COPY INTO .

• Komut çalışırken başvuruda bulunan dosya veya klasörlerin değiştirilmesi, silinmesi veya değiştirilmesi işlemin başarısız olmasına veya tutarsız veri alımına neden olabilir.
• yürütmeden COPY INTOönce tüm kaynak verilerin kararlı olduğunu ve işlem sırasında değiştirilmeydüğünü doğrulayın.

Kaynak verilerin duyarlılığı hedef sütun tanımından daha büyükse, sayısal, tarih ve saat türleri için değer yuvarlanmamış olarak kesilir.

Examples

A. Genel depolama hesabından yükleme

Aşağıdaki örnekte, genel depolama hesabından veri yükleyen komutun COPY en basit biçimi gösterilmektedir. Bu örnekte deyiminin COPY varsayılan değerleri, satır öğesi CSV dosyasının biçimiyle eşleşmektedir.

COPY INTO dbo.[lineitem]
FROM 'https://unsecureaccount.blob.core.windows.net/customerdatasets/folder1/lineitem.csv'
WITH (FIELDTERMINATOR = '|')

COPY komutunun varsayılan değerleri şunlardır:

• DATEFORMAT = Oturum TARİhİFORMATİ

• MAXERRORS = 0

• COMPRESSION varsayılan sıkıştırılmamıştır

• FIELDQUOTE = '"'

• FIELDTERMINATOR = ','

• ROWTERMINATOR = '\n'

Important

COPY Dahili \n olarak \r\n muamele eder. Daha fazla bilgi için bölümüne bakın ROWTERMINATOR .

• FIRSTROW = 1

• ENCODING = 'UTF8'

• FILE_TYPE = 'CSV'

• IDENTITY_INSERT = 'KAPALI'

B. Paylaşım Erişim İmzası (SAS) aracılığıyla yük kimlik doğrulaması

Aşağıdaki örnek, unix çıkışı gibi satır sonlandırıcısı olarak satır akışını kullanan dosyaları yükler. Bu örnek, Azure Blob Depolama'da kimlik doğrulaması yapmak için bir SAS anahtarı da kullanır.

COPY INTO test_1
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder1/'
WITH (
    FILE_TYPE = 'CSV',
    CREDENTIAL=(IDENTITY= 'Shared Access Signature', SECRET='<Your_SAS_Token>'),
    --CREDENTIAL should look something like this:
    --CREDENTIAL=(IDENTITY= 'Shared Access Signature', SECRET='?sv=2018-03-28&ss=bfqt&srt=sco&sp=rl&st=2016-10-17T20%3A14%3A55Z&se=2021-10-18T20%3A19%3A00Z&sig=IEoOdmeYnE9%2FKiJDSHFSYsz4AkNa%2F%2BTx61FuQ%2FfKHefqoBE%3D'),
    FIELDQUOTE = '"',
    FIELDTERMINATOR=';',
    ROWTERMINATOR='0X0A',
    ENCODING = 'UTF8',
    DATEFORMAT = 'ymd',
    MAXERRORS = 10,
    ERRORFILE = '/errorsfolder',--path starting from the storage container
    IDENTITY_INSERT = 'ON'
)

C. Depolama Hesabı Anahtarı aracılığıyla kimlik doğrulaması varsayılan değerleri içeren bir sütun listesiyle yükleme

Bu örnek, varsayılan değerlerle bir sütun listesi belirten dosyaları yükler.

--Note when specifying the column list, input field numbers start from 1
COPY INTO test_1 (Col_one default 'myStringDefault' 1, Col_two default 1 3)
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder1/'
WITH (
    FILE_TYPE = 'CSV',
    CREDENTIAL=(IDENTITY= 'Storage Account Key', SECRET='<Your_Account_Key>'),
    FIELDQUOTE = '"',
    FIELDTERMINATOR=',',
    ROWTERMINATOR='0x0A',
    ENCODING = 'UTF8',
    FIRSTROW = 2
)

D. Mevcut dosya biçimi nesnesini kullanarak Parquet veya ORC yükleme

Bu örnekte, tüm Parquet dosyalarını bir klasörün altına yüklemek için joker karakter kullanılır.

COPY INTO test_parquet
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder1/*.parquet'
WITH (
    FILE_FORMAT = myFileFormat,
    CREDENTIAL=(IDENTITY= 'Shared Access Signature', SECRET='<Your_SAS_Token>')
)

E. Joker kartları ve birden çok dosyayı belirtmeyi yükleme

COPY INTO t1
FROM
'https://myaccount.blob.core.windows.net/myblobcontainer/folder0/*.txt',
    'https://myaccount.blob.core.windows.net/myblobcontainer/folder1'
WITH (
    FILE_TYPE = 'CSV',
    CREDENTIAL=(IDENTITY= '<client_id>@<OAuth_2.0_Token_EndPoint>',SECRET='<key>'),
    FIELDTERMINATOR = '|'
)

F. MSI kimlik bilgilerini kullanarak yükleme

COPY INTO dbo.myCOPYDemoTable
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder0/*.txt'
WITH (
    FILE_TYPE = 'CSV',
    CREDENTIAL = (IDENTITY = 'Managed Identity'),
    FIELDQUOTE = '"',
    FIELDTERMINATOR=','
)

G. Otomatik şema algılama kullanarak yükleme

COPY INTO [myCOPYDemoTable]
FROM 'https://myaccount.blob.core.windows.net/customerdatasets/folder1/lineitem.parquet'
WITH (
    FILE_TYPE = 'Parquet',
    CREDENTIAL = ( IDENTITY = 'Shared Access Signature',  SECRET='<key>'),
    AUTO_CREATE_TABLE = 'ON'
)

FAQ

COPY komutunun performansı PolyBase ile karşılaştırıldığında nasıldır?

COPY komutunun performansı, iş yükünüze bağlı olarak daha iyi olabilir.

• Ambar, sıkıştırılmış dosyaları otomatik olarak bölemez. En iyi yükleme performansı için sıkıştırılmış CSV'leri yüklerken girişinizi birden çok dosyaya bölmeyi göz önünde bulundurun.

• Ambar, paralel yükleme için büyük sıkıştırılmamış CSV dosyalarını otomatik olarak bölebilir, bu nedenle genellikle sıkıştırılmamış CSV dosyalarını el ile bölmeniz gerekmez. Veri özellikleri nedeniyle otomatik dosya bölmenin mümkün olmadığı bazı durumlarda, büyük CSV'lerin el ile bölünmesi performansa hala fayda sağlayabilir.

Sıkıştırılmış CSV dosyalarını yüken COPY komutu için dosya bölme kılavuzu nedir?

Aşağıdaki tabloda kullanmanız gereken dosya sayısı özetlenmiştir. Önerilen dosya sayısına ulaştığınızda, daha büyük dosyalarla daha iyi performans elde edersiniz. Dosya sayısı, 60 ile çarpılan işlem düğümü sayısına göre belirlenir. Örneğin, 6000 DWU'da 12 işlem düğümüne sahip olduğunuz için 12 * 60 = 720 bölüme sahip olursunuz. Basit bir dosya bölme deneyimi için bkz. Dosya bölmeleriyle COPY yük aktarım hızını en üst düzeye çıkarma.

DWU	Dosya sayısı
100	60
200	60
300	60
400	60
500	60
1,000	120
1,500	180
2,000	240
2,500	300
3,000	360
5,000	600
6,000	720
7,500	900
10,000	1200
15,000	1800
30,000	3600

Parquet veya ORC dosyalarını yüken COPY komutu için dosya bölme kılavuzu nedir?

COPY komutu dosyaları otomatik olarak böldüğünden Parquet ve ORC dosyalarını bölmeniz gerekmez. En iyi performans için, Azure depolama hesabındaki Parquet ve ORC dosyaları 256 MB veya daha büyük olmalıdır.

Dosyaların sayısı veya boyutuyla ilgili herhangi bir sınırlama var mı?

Dosyaların sayısı veya boyutuyla ilgili herhangi bir sınırlama yoktur. Ancak, en iyi performans için en az 4 MB olan dosyaları kullanın. Ayrıca, daha iyi performans için kaynak dosya sayısını en fazla 5.000 dosyayla sınırlayın.

COPY deyimiyle ilgili bilinen sorunlar var mı?

7 Aralık 2020'den önce oluşturduğunuz bir Azure Synapse çalışma alanınız varsa, Yönetilen Kimlik kullanarak kimlik doğrulaması yaparken benzer bir hata iletisiyle karşılaşabilirsiniz: com.microsoft.sqlserver.jdbc.SQLServerException: Managed Service Identity isn't enabled on this server. Please enable Managed Service Identity and try again.

Bu sorunu geçici olarak çözmek için çalışma alanının yönetilen kimliğini yeniden kaydedin:

1. Azure PowerShell'i yükleyin. Bkz. PowerShell'i yükleme.
2. PowerShell kullanarak çalışma alanınızın yönetilen kimliğini kaydedin:

   Connect-AzAccount
   Select-AzSubscription -SubscriptionId <subscriptionId>
   Set-AzSqlServer -ResourceGroupName your-database-server-resourceGroup -ServerName your-SQL-servername -AssignIdentity
   

İlgili içerik

• Azure Synapse Analytics ile yüklemeye genel bakış