복사 작업에서 Azure Table Storage 구성
이 문서에서는 데이터 파이프라인의 복사 작업을 사용하여 Azure Table Storage에서 데이터를 복사하는 방법을 간략하게 설명합니다.
지원되는 구성
복사 작업 아래의 각 탭을 구성하려면 각각 다음 섹션으로 이동합니다.
일반
일반 설정 탭을 구성하려면 일반 설정 지침을 참조하세요.
원본
원본 탭으로 이동하여 복사 작업 원본을 구성합니다. 자세한 구성은 다음 내용을 참조하세요.
다음 3개의 속성은 필수입니다.
데이터 저장소 유형: 외부를 선택합니다.
연결: 연결 목록에서 Azure Table Storage 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 Azure Table Storage 연결을 만듭니다.
쿼리 사용: 데이터를 읽는 방식을 지정합니다. 테이블을 선택하여 지정된 테이블에서 데이터를 읽거나 쿼리를 사용하여 데이터를 읽을 쿼리를 선택합니다.
테이블을 선택한 경우:
- 테이블: Azure Table Storage 데이터베이스 인스턴스에서 테이블의 이름을 지정합니다. 드롭다운 목록에서 테이블을 선택하거나 편집을 선택하여 수동으로 이름을 입력합니다.
쿼리를 선택하는 경우:
테이블: Azure Table Storage 데이터베이스 인스턴스에서 테이블의 이름을 지정합니다. 드롭다운 목록에서 테이블을 선택하거나 편집을 선택하여 수동으로 이름을 입력합니다.
쿼리: 데이터를 읽는 사용자 지정 Table Storage 쿼리를 지정합니다. 원본 쿼리는 Azure Table Storage에서 지원하는
$filter쿼리 옵션의 직접 맵입니다. 이 문서의 구문에 대해 자세히 알아보세요.참고 항목
Azure Table 쿼리 작업은 Azure Table service에서 적용된 대로 30초 후에 시간 초과됩니다. 쿼리 디자인 문서에서 쿼리를 최적화하는 방법을 알아보세요.
고급에서 다음 필드를 지정할 수 있습니다.
테이블을 찾을 수 없음 무시: 테이블의 예외가 존재하지 않도록 허용할지 여부를 지정합니다. 기본적으로 선택되지 않습니다.
추가 열: 데이터 열을 추가하여 원본 파일의 상대 경로 또는 정적 값을 저장하세요. 식은 정적 값에 대해 지원됩니다.
대상
대상 탭으로 이동하여 복사 작업 대상을 구성합니다. 자세한 구성은 다음 내용을 참조하세요.
다음 3개의 속성은 필수입니다.
- 데이터 저장소 유형: 외부를 선택합니다.
- 연결: 연결 목록에서 Azure Table Storage 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 Azure Table Storage 연결을 만듭니다.
- 테이블: Azure Table Storage 데이터베이스 인스턴스에서 테이블의 이름을 지정합니다. 드롭다운 목록에서 테이블을 선택하거나 편집을 선택하여 수동으로 이름을 입력합니다.
고급에서 다음 필드를 지정할 수 있습니다.
삽입 유형: Azure Table에 데이터를 삽입하는 모드를 선택합니다. 모드에는 Merge와 Replace가 있습니다. 이 속성은 출력 테이블에서 파티션 및 행 키가 일치하는 기존 행의 값을 바꿀지 또는 병합할지 제어합니다. 이 설정은 테이블 수준이 아닌 행 수준에 적용됩니다. 두 옵션 모두 출력 테이블에서 입력에 존재하지 않는 행을 삭제하지 않습니다. merge 및 replace 설정이 작동하는 방법을 알아보려면 Insert Or Merge Entity(엔터티 삽입 또는 병합) 및 Insert Or Replace Entity(엔터티 삽입 또는 바꾸기)를 참조하세요.
파티션 키 값 선택: 파티션 값 지정 또는 대상 열 사용 중에서 선택합니다. 파티션 키 값은 고정 값이 될 수도 있고 대상 열에서 값을 가져올 수도 있습니다.
파티션 값 지정을 선택하는 경우:
- 기본 파티션 값: 대상에서 사용할 수 있는 기본 파티션 키 값을 지정합니다.
대상 열 사용을 선택하는 경우:
- 파티션 키 열: 열 값이 파티션 키로 사용되는 열의 이름을 선택합니다. 지정하지 않으면 "AzureTableDefaultPartitionKeyValue"가 파티션 키로 사용됩니다.
행 키 값 선택: 고유 식별자 또는 대상 열 사용 중에서 선택합니다. 행 키 값은 자동 생성된 고유 식별자가 될 수도 있고 대상 열에서 값을 가져올 수도 있습니다.
대상 열 사용을 선택하는 경우:
- 행 키 열: 열 값이 행 키로 사용되는 열의 이름을 선택합니다. 지정하지 않으면 각 행에 GUID를 사용합니다.
쓰기 일괄 처리 크기: 지정된 쓰기 일괄 처리 크기에 도달하면 Azure Table에 데이터를 삽입합니다. 허용되는 값은 정수(행 수)입니다. 기본값은 10,000입니다.
쓰기 일괄 처리 시간 제한: 지정된 쓰기 일괄 처리 시간 제한에 도달하면 Azure Table에 데이터를 삽입합니다. 허용되는 값은 시간 범위입니다.
최대 동시 연결: 작업 실행 중 데이터 저장소에 설정된 동시 연결의 상한입니다. 동시 연결을 제한하려는 경우에만 값을 지정합니다.
매핑
매핑 탭 구성의 경우 매핑 탭에서 매핑 구성을 참조하세요.
설정
설정 탭을 구성하려면 설정 탭에서 기타 설정 구성으로 이동합니다.
표 요약
다음 표에는 Azure Table Storage의 복사 활동에 대한 자세한 정보가 포함되어 있습니다.
원본 정보
| 이름 | 설명 | 값 | 필수 | JSON 스크립트 속성 |
|---|---|---|---|---|
| 데이터 저장소 유형 | 데이터 저장소 유형입니다. | 외부 | 예 | / |
| 연결 | 원본 데이터 저장소에 대한 연결입니다. | < Azure Table Storage 연결 > | 예 | connection |
| 쿼리 사용 | 데이터를 읽는 방법. 테이블을 적용하여 지정된 테이블에서 데이터를 읽거나 쿼리를 적용하여 쿼리를 사용하여 데이터를 읽습니다. | • 테이블 • 쿼리 |
예 | / |
| 테이블 | Azure Table Storage 데이터베이스 인스턴스의 테이블 이름입니다. | < 테이블 이름 > | 예 | tableName |
| 쿼리 | 사용자 지정 Table Storage 쿼리를 지정하여 데이터를 읽습니다. 원본 쿼리는 Azure Table Storage에서 지원하는 $filter 쿼리 옵션의 직접 맵입니다. 이 문서의 구문에 대해 자세히 알아보세요. |
< 쿼리 > | 아니요 | AzureTableSourceQuery |
| 테이블을 찾을 수 없음 무시 | 테이블의 예외가 존재하지 않도록 허용할지 여부를 나타냅니다. | 선택되거나 선택되지 않음(기본값) | 아니요 | azureTableSourceIgnoreTableNotFound: true 또는 false(기본값) |
| 추가 열 | 데이터 열을 추가하여 원본 파일의 상대 경로 또는 정적 값을 저장하세요. 식은 정적 값에 대해 지원됩니다. | • 이름 • 값 |
아니요 | additionalColumns: • 이름 • 값 |
대상 정보
| 이름 | 설명 | 값 | 필수 | JSON 스크립트 속성 |
|---|---|---|---|---|
| 데이터 저장소 유형 | 데이터 저장소 유형입니다. | 외부 | 예 | / |
| 연결 | 대상 데이터 저장소에 대한 연결입니다. | < Azure Table Storage 연결 > | 예 | connection |
| 테이블 | Azure Table Storage 데이터베이스 인스턴스의 테이블 이름입니다. | < 테이블 이름 > | 예 | tableName |
| 삽입 유형 | Azure Table에 데이터를 삽입하는 모드입니다. 이 속성은 출력 테이블에서 파티션 및 행 키가 일치하는 기존 행의 값을 바꿀지 또는 병합할지 제어합니다. | • Merge • Replace |
아니요 | azureTableInsertType: • merge • replace |
| 파티션 키 값 선택 | 파티션 키 값은 고정 값이 될 수도 있고 대상 열에서 값을 가져올 수도 있습니다. | • 파티션 값 지정 • 대상 열 사용 |
아니요 | / |
| 기본 파티션 값 | 대상에서 사용할 수 있는 기본 파티션 키 값입니다. | < 기본 파티션 값 > | 아니요 | azureTableDefaultPartitionKeyValue |
| 파티션 키 열 | 값이 파티션 키로 사용되는 열의 이름입니다. 지정하지 않으면 "AzureTableDefaultPartitionKeyValue"가 파티션 키로 사용됩니다. | < 파티션 키 열 > | 아니요 | azureTablePartitionKeyName |
| 행 키 값 선택 | 행 키 값은 자동 생성된 고유 식별자가 될 수도 있고 대상 열에서 값을 가져올 수도 있습니다. | • 고유 식별자 • 대상 열 사용 |
아니요 | / |
| 행 키 열 | 열 값이 행 키로 사용되는 열의 이름입니다. 지정하지 않으면 각 행에 GUID를 사용합니다. | < 행 키 열 > | 아니요 | azureTableRowKeyName |
| 쓰기 일괄 처리 크기 | 쓰기 일괄 처리 크기에 도달하면 Azure Table에 데이터를 삽입합니다. | 정수 (기본값: 10,000) |
아니요 | writeBatchSize |
| 쓰기 일괄 처리 시간 제한 | 쓰기 일괄 처리 시간 제한에 도달하면 Azure Table에 데이터를 삽입합니다. | timespan | 아니요 | writeBatchTimeout |
| 최대 동시 연결 수 | 작업 실행 중 데이터 저장소에 설정된 동시 연결의 상한입니다. 동시 연결을 제한하려는 경우에만 값을 지정합니다. | < 최대 동시 연결 수 > | 아니요 | maxConcurrentConnections |