Skip to content

Commit 12b2276

Browse files
20251016 COPY INTO acrolinx
1 parent 68a9524 commit 12b2276

1 file changed

Lines changed: 11 additions & 11 deletions

File tree

docs/t-sql/statements/copy-into-transact-sql.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -199,7 +199,7 @@ Multiple file locations can only be specified from the same storage account and
199199

200200
#### *ERRORFILE = Directory Location*
201201

202-
*ERRORFILE* only applies to CSV. Specifies the directory within the COPY statement where the rejected rows and the corresponding error file should be written. The full path from the storage account can be specified or the path relative to the container can be specified. If the specified path doesn't exist, one is created on your behalf. A child directory is created with the name "\_rejectedrows". The "\_" character ensures that the directory is escaped for other data processing unless explicitly named in the location parameter.
202+
*ERRORFILE* only applies to CSV. Specifies the directory within the COPY statement where the rejected rows and the corresponding error file should be written. The full path from the storage account can be specified or the path relative to the container can be specified. If the specified path doesn't exist, one is created on your behalf. A child directory is created with the name `_rejectedrows`. The `_` character ensures that the directory is escaped for other data processing unless explicitly named in the location parameter.
203203

204204
> [!NOTE]
205205
> When a relative path is passed to *ERRORFILE*, the path is relative to the container path specified in *external_location*.
@@ -247,7 +247,7 @@ Using a storage account key with ERRORFILE_CREDENTIAL is not supported.
247247

248248
*MAXERRORS* cannot be used with AUTO_CREATE_TABLE.
249249

250-
When *FILE_TYPE* is 'PARQUET', exceptions that are caused by data type conversion errors (e.g., Parquet binary to SQL integer) still cause COPY INTO will to fail, ignoring *MAXERRORS*.
250+
When *FILE_TYPE* is `PARQUET`, exceptions that are caused by data type conversion errors (for example, Parquet binary to SQL integer) still cause `COPY INTO` to fail, ignoring *MAXERRORS*.
251251

252252
#### *COMPRESSION = { 'DefaultCodec ' | 'Snappy' | 'GZIP' | 'NONE'}*
253253

@@ -523,7 +523,7 @@ There's no need to split Parquet and ORC files because the COPY command automati
523523

524524
### Are there any limitations on the number or size of files?
525525

526-
There are no limitations on the number or size of files; however, for best performance, we recommend files that are at least 4 MB. Also, limit the count of source files to a maximum of 5000 files for better performance.
526+
There are no limitations on the number or size of files; however, for best performance, we recommend files that are at least 4 MB. Also, limit the count of source files to a maximum of 5,000 files for better performance.
527527

528528
### Are there any known issues with the COPY statement?
529529

@@ -555,7 +555,7 @@ In [!INCLUDE [fabric](../../includes/fabric.md)], the [COPY (Transact-SQL)](/sql
555555

556556
For more information on using COPY INTO on your [!INCLUDE [fabricdw](../../includes/fabric-dw.md)] in [!INCLUDE [fabric](../../includes/fabric.md)], see [Ingest data into your [!INCLUDE [fabricdw](../../includes/fabric-dw.md)] using the COPY statement](/fabric/data-warehouse/ingest-data-copy).
557557

558-
By default, `COPY INTO` will authenticate as the executing Entra ID user.
558+
By default, `COPY INTO` authenticates as the executing Entra ID user.
559559

560560
> [!NOTE]
561561
> For [!INCLUDE[ssazuresynapse_md](../../includes/ssazuresynapse-md.md)], visit [COPY INTO for [!INCLUDE [ssazuresynapse_md](../../includes/ssazuresynapse-md.md)]](copy-into-transact-sql.md?view=azure-sqldw-latest&preserve-view=true).
@@ -682,7 +682,7 @@ To access files on Azure Data Lake Storage (ADLS) Gen2 and Azure Blob Storage lo
682682

683683
*CREDENTIAL* specifies the authentication mechanism to access the external storage account. On [!INCLUDE [fabric-dw](../../includes/fabric-dw.md)] in [!INCLUDE [fabric](../../includes/fabric.md)], the only supported authentication mechanisms are Shared Access Signature (SAS) and Storage Account Key (SAK).
684684

685-
The user's EntraID authentication is default, no credential needs to be specified. COPY INTO using OneLake as source only supports EntraID authentication.
685+
The user's EntraID authentication is default. No credential needs to be specified. COPY INTO using OneLake as source only supports EntraID authentication.
686686

687687
> [!NOTE]
688688
> When using a public storage account, CREDENTIAL does not need to be specified. By default the executing user's Entra ID is used.
@@ -700,7 +700,7 @@ The user's EntraID authentication is default, no credential needs to be specifie
700700

701701
#### *ERRORFILE = Directory Location*
702702

703-
*ERRORFILE* only applies to CSV. Specifies the directory where the rejected rows and the corresponding error file should be written. The full path from the storage account can be specified or the path relative to the container can be specified. If the specified path doesn't exist, one is created on your behalf. A child directory is created with the name "\_rejectedrows". The "\_" character ensures that the directory is escaped for other data processing unless explicitly named in the location parameter.
703+
*ERRORFILE* only applies to CSV. Specifies the directory where the rejected rows and the corresponding error file should be written. The full path from the storage account can be specified or the path relative to the container can be specified. If the specified path doesn't exist, one is created on your behalf. A child directory is created with the name `_rejectedrows`. The `_` character ensures that the directory is escaped for other data processing unless explicitly named in the location parameter.
704704

705705
> [!NOTE]
706706
> When a relative path is passed to *ERRORFILE*, the path is relative to the container path specified in *external_location*.
@@ -709,7 +709,7 @@ Within this directory, there's a folder created based on the time of load submis
709709

710710
If ERRORFILE has the full path of the storage account defined, then the ERRORFILE_CREDENTIAL is used to connect to that storage. Otherwise, the value mentioned for CREDENTIAL is used. When the same credential that is used for the source data is used for ERRORFILE, restrictions that apply to ERRORFILE_CREDENTIAL also apply.
711711

712-
When using a firewall protected Azure Storage Account, the error file will be created in the same container specified in the storage account path. When considering using the *ERRORFILES* option in this scenario, it is also required to specify the *MAXERROR* parameter. If ERRORFILE has the full path of the storage account defined, then the ERRORFILE_CREDENTIAL is used to connect to that storage. Otherwise, the value mentioned for CREDENTIAL is used.
712+
When using a firewall protected Azure Storage Account, the error file is created in the same container specified in the storage account path. When considering using the *ERRORFILES* option in this scenario, it is also required to specify the *MAXERROR* parameter. If ERRORFILE has the full path of the storage account defined, then the ERRORFILE_CREDENTIAL is used to connect to that storage. Otherwise, the value mentioned for CREDENTIAL is used.
713713

714714
#### *ERRORFILE_CREDENTIAL = (IDENTITY= '', SECRET = '')*
715715

@@ -727,7 +727,7 @@ When using a firewall protected Azure Storage Account, the error file will be cr
727727

728728
*MAXERRORS* specifies the maximum number of reject rows allowed in the load before the COPY operation fails. Each row that the COPY operation can't import is ignored and counted as one error. If max_errors isn't specified, the default is 0.
729729

730-
In Microsoft Fabric, *MAXERRORS* cannot be used when *FILE_TYPE* is 'PARQUET'.
730+
In Microsoft Fabric, *MAXERRORS* cannot be used when *FILE_TYPE* is `PARQUET`.
731731

732732
#### *COMPRESSION = { 'Snappy' | 'GZIP' | 'NONE'}*
733733

@@ -855,7 +855,7 @@ When using OneLake as the source, the user must have **Contributor** or higher p
855855
The COPY statement accepts only UTF-8 and UTF-16 valid characters for row data and command parameters. Source files or parameters (such as `ROW TERMINATOR` or `FIELD TERMINATOR`) that use invalid characters might be interpreted incorrectly by the COPY statement and cause unexpected results such as data corruption, or other failures. Make sure your source files and parameters are UTF-8 or UTF-16 compliant before you invoke the COPY statement.
856856

857857
To ensure reliable execution, the source files and folders must remain unchanged throughout the duration of the COPY INTO operation.
858-
- Modifying, deleting, or replacing any referenced files or folders while the command is running may cause the operation to fail or result in inconsistent data ingestion.
858+
- Modifying, deleting, or replacing any referenced files or folders while the command is running can cause the operation to fail or result in inconsistent data ingestion.
859859
- Before executing COPY INTO, verify that all source data is stable and will not be altered during the process.
860860

861861
<a id="limitations-for-onelake-as-source-public-preview"></a>
@@ -950,7 +950,7 @@ WITH (
950950

951951
### D. Load Parquet
952952

953-
This example uses a wildcard to load all Parquet files under a folder using the executing user's EntraID.
953+
This example uses a wildcard to load all Parquet files under a folder using the executing user's Entra ID.
954954

955955
```sql
956956
COPY INTO test_parquet
@@ -1001,7 +1001,7 @@ There are no limitations on the number or size of files; however, for best perfo
10011001

10021002
### What authentication method is used when I don't specify a credential?
10031003

1004-
By default, `COPY INTRO` will use the executing user's Entra ID.
1004+
By default, `COPY INTRO` uses the executing user's Entra ID.
10051005

10061006
## Related content
10071007

0 commit comments

Comments
 (0)