az datafactory integration-runtime

참고

이 참조는 Azure CLI 대한 데이터 팩터리 확장의 일부이며 버전 2.15.0 이상에 필요합니다. az datafactory integration-runtime 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

데이터 팩터리로 통합 런타임을 관리합니다.

명령

az datafactory integration-runtime delete

통합 런타임을 삭제합니다.

az datafactory integration-runtime get-connection-info

온-프레미스 데이터 원본 자격 증명을 암호화하기 위한 온-프레미스 통합 런타임 연결 정보를 가져옵니다.

az datafactory integration-runtime get-monitoring-data

이 통합 런타임의 모든 노드에 대한 모니터 데이터를 포함하는 통합 런타임 모니터링 데이터를 얻습니다.

az datafactory integration-runtime get-status

통합 런타임에 대한 자세한 상태 정보를 가져옵니다.

az datafactory integration-runtime linked-integration-runtime

데이터 팩터리 하위 그룹 linked-integration-runtime을 통해 통합 런타임을 관리합니다.

az datafactory integration-runtime linked-integration-runtime create

공유 통합 런타임에 연결된 통합 런타임 항목을 만듭니다.

az datafactory integration-runtime list

통합 런타임을 나열합니다.

az datafactory integration-runtime list-auth-key

통합 런타임에 대한 인증 키를 검색합니다.

az datafactory integration-runtime managed

관리되는 데이터 팩터리 하위 그룹을 통해 통합 런타임을 관리합니다.

az datafactory integration-runtime managed create

통합 런타임을 만듭니다.

az datafactory integration-runtime regenerate-auth-key

통합 런타임에 대한 인증 키를 다시 생성합니다.

az datafactory integration-runtime remove-link

자체 호스팅 통합 런타임의 특정 데이터 팩터리에서 연결된 통합 런타임을 모두 제거합니다.

az datafactory integration-runtime self-hosted

데이터 팩터리 하위 그룹을 자체 호스팅하여 통합 런타임을 관리합니다.

az datafactory integration-runtime self-hosted create

통합 런타임을 만듭니다.

az datafactory integration-runtime show

통합 런타임을 가져옵니다.

az datafactory integration-runtime start

ManagedReserved 형식 통합 런타임을 시작합니다.

az datafactory integration-runtime stop

ManagedReserved 형식 통합 런타임을 중지합니다.

az datafactory integration-runtime sync-credentials

통합 런타임이 통합 런타임 노드 간에 자격 증명을 동기화하도록 강제하면 모든 작업자 노드의 자격 증명이 디스패처 노드에서 사용할 수 있는 자격 증명으로 재정의됩니다. 최신 자격 증명 백업 파일이 이미 있는 경우 이 API를 직접 사용하는 것보다 자체 호스팅 통합 런타임 노드에서 수동으로 가져와야 합니다(기본 설정).

az datafactory integration-runtime update

통합 런타임을 업데이트합니다.

az datafactory integration-runtime upgrade

가용성이 있는 경우 자체 호스팅 통합 런타임을 최신 버전으로 업그레이드합니다.

az datafactory integration-runtime wait

데이터 팩터리 통합 런타임 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az datafactory integration-runtime delete

통합 런타임을 삭제합니다.

az datafactory integration-runtime delete --factory-name
                                          --integration-runtime-name
                                          --resource-group
                                          [--yes]

예제

IntegrationRuntimes_Delete

az datafactory integration-runtime delete --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az datafactory integration-runtime get-connection-info

온-프레미스 데이터 원본 자격 증명을 암호화하기 위한 온-프레미스 통합 런타임 연결 정보를 가져옵니다.

az datafactory integration-runtime get-connection-info --factory-name
                                                       --integration-runtime-name
                                                       --resource-group

예제

IntegrationRuntimes_GetConnectionInfo

az datafactory integration-runtime get-connection-info --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az datafactory integration-runtime get-monitoring-data

이 통합 런타임의 모든 노드에 대한 모니터 데이터를 포함하는 통합 런타임 모니터링 데이터를 얻습니다.

az datafactory integration-runtime get-monitoring-data --factory-name
                                                       --integration-runtime-name
                                                       --resource-group

예제

IntegrationRuntimes_GetMonitoringData

az datafactory integration-runtime get-monitoring-data --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az datafactory integration-runtime get-status

통합 런타임에 대한 자세한 상태 정보를 가져옵니다.

az datafactory integration-runtime get-status --factory-name
                                              --integration-runtime-name
                                              --resource-group

예제

IntegrationRuntimes_GetStatus

az datafactory integration-runtime get-status --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az datafactory integration-runtime list

통합 런타임을 나열합니다.

az datafactory integration-runtime list --factory-name
                                        --resource-group

예제

IntegrationRuntimes_ListByFactory

az datafactory integration-runtime list --factory-name "exampleFactoryName" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az datafactory integration-runtime list-auth-key

통합 런타임에 대한 인증 키를 검색합니다.

az datafactory integration-runtime list-auth-key --factory-name
                                                 --integration-runtime-name
                                                 --resource-group

예제

IntegrationRuntimes_ListAuthKeys

az datafactory integration-runtime list-auth-key --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az datafactory integration-runtime regenerate-auth-key

통합 런타임에 대한 인증 키를 다시 생성합니다.

az datafactory integration-runtime regenerate-auth-key --factory-name
                                                       --integration-runtime-name
                                                       --resource-group
                                                       [--key-name {authKey1, authKey2}]

예제

IntegrationRuntimes_RegenerateAuthKey

az datafactory integration-runtime regenerate-auth-key --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --key-name "authKey2" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--key-name

다시 생성할 인증 키의 이름입니다.

허용되는 값: authKey1, authKey2

자체 호스팅 통합 런타임의 특정 데이터 팩터리에서 연결된 통합 런타임을 모두 제거합니다.

az datafactory integration-runtime remove-link --factory-name
                                               --integration-runtime-name
                                               --linked-factory-name
                                               --resource-group

IntegrationRuntimes_Upgrade

az datafactory integration-runtime remove-link --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --linked-factory-name "exampleFactoryName-linked" --resource-group "exampleResourceGroup"
--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--linked-factory-name

연결된 통합 런타임의 데이터 팩터리 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az datafactory integration-runtime show

통합 런타임을 가져옵니다.

az datafactory integration-runtime show --factory-name
                                        --integration-runtime-name
                                        --resource-group
                                        [--if-none-match]

예제

IntegrationRuntimes_Get

az datafactory integration-runtime show --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--if-none-match

통합 런타임 엔터티의 ETag입니다. get에 대해서만 지정해야 합니다. ETag가 기존 엔터티 태그와 일치하거나 가 제공된 경우 * 콘텐츠가 반환되지 않습니다.

az datafactory integration-runtime start

ManagedReserved 형식 통합 런타임을 시작합니다.

az datafactory integration-runtime start --factory-name
                                         --integration-runtime-name
                                         --resource-group
                                         [--no-wait]

예제

IntegrationRuntimes_Start

az datafactory integration-runtime start --factory-name "exampleFactoryName" --name "exampleManagedIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

az datafactory integration-runtime stop

ManagedReserved 형식 통합 런타임을 중지합니다.

az datafactory integration-runtime stop --factory-name
                                        --integration-runtime-name
                                        --resource-group
                                        [--no-wait]

예제

IntegrationRuntimes_Stop

az datafactory integration-runtime stop --factory-name "exampleFactoryName" --name "exampleManagedIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

az datafactory integration-runtime sync-credentials

통합 런타임이 통합 런타임 노드 간에 자격 증명을 동기화하도록 강제하면 모든 작업자 노드의 자격 증명이 디스패처 노드에서 사용할 수 있는 자격 증명으로 재정의됩니다. 최신 자격 증명 백업 파일이 이미 있는 경우 이 API를 직접 사용하는 것보다 자체 호스팅 통합 런타임 노드에서 수동으로 가져와야 합니다(기본 설정).

az datafactory integration-runtime sync-credentials --factory-name
                                                    --integration-runtime-name
                                                    --resource-group

예제

IntegrationRuntimes_SyncCredentials

az datafactory integration-runtime sync-credentials --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az datafactory integration-runtime update

통합 런타임을 업데이트합니다.

az datafactory integration-runtime update --factory-name
                                          --integration-runtime-name
                                          --resource-group
                                          [--auto-update {Off, On}]
                                          [--update-delay-offset]

예제

IntegrationRuntimes_Update

az datafactory integration-runtime update --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup" --auto-update "Off" --update-delay-offset "\"PT3H\""

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--auto-update

자체 호스팅 통합 런타임의 자동 업데이트 기능을 사용하거나 사용하지 않도록 설정합니다. https://go.microsoft.com/fwlink/?linkid=854189을 참조하세요.

허용되는 값: Off, On
--update-delay-offset

하루의 시간 오프셋(시간)(예: PT03H)은 3시간입니다. 통합 런타임 자동 업데이트는 해당 시간에 발생합니다.

az datafactory integration-runtime upgrade

가용성이 있는 경우 자체 호스팅 통합 런타임을 최신 버전으로 업그레이드합니다.

az datafactory integration-runtime upgrade --factory-name
                                           --integration-runtime-name
                                           --resource-group

예제

IntegrationRuntimes_Upgrade

az datafactory integration-runtime upgrade --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az datafactory integration-runtime wait

데이터 팩터리 통합 런타임 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az datafactory integration-runtime wait --factory-name
                                        --integration-runtime-name
                                        --resource-group
                                        [--created]
                                        [--custom]
                                        [--deleted]
                                        [--exists]
                                        [--if-none-match]
                                        [--interval]
                                        [--timeout]
                                        [--updated]

예제

datafactory integration-runtime이 성공적으로 만들어질 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az datafactory integration-runtime wait --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup" --created

필수 매개 변수

--factory-name

팩터리 이름입니다.

--integration-runtime-name --name -n

통합 런타임 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

--exists

리소스가 존재할 때까지 기다립니다.

--if-none-match

통합 런타임 엔터티의 ETag입니다. get에 대해서만 지정해야 합니다. ETag가 기존 엔터티 태그와 일치하거나 가 제공된 경우 * 콘텐츠가 반환되지 않습니다.

--interval

폴링 간격(초)입니다.

기본값: 30
--timeout

최대 대기 시간(초)입니다.

기본값: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.