Azure Logic Apps에서 온-프레미스 데이터 원본에 연결Connect to on-premises data sources from Azure Logic Apps

로컬 컴퓨터에 온 -프레미스 데이터 게이트웨이 를 설치 하 고 논리 앱에서 온-프레미스의 데이터 원본에 액세스 하려면 먼저 게이트웨이 설치를 위해 Azure에서 게이트웨이 리소스를 만들어야 합니다.After you install the on-premises data gateway on a local computer and before you can access data sources on premises from your logic apps, you need to create a gateway resource in Azure for your gateway installation. 그런 다음 Azure Logic Apps에서 사용할 수 있는 온-프레미스 커넥터 에 사용 하려는 트리거와 작업에서이 게이트웨이 리소스를 선택할 수 있습니다.You can then select this gateway resource in the triggers and actions that you want to use for the on-premises connectors available in Azure Logic Apps. Azure Logic Apps는 데이터 게이트웨이를 통해 읽기 및 쓰기 작업을 지원 합니다.Azure Logic Apps supports read and write operations through the data gateway. 그러나 이러한 작업에는 페이로드 크기 제한이 있습니다.However, these operations have limits on their payload size.

이 문서에서는 로컬 컴퓨터에이전에 설치 된 게이트웨이에 대 한 Azure 게이트웨이 리소스를 만드는 방법을 보여 줍니다.This article shows how to create your Azure gateway resource for a previously installed gateway on your local computer. 게이트웨이에 대 한 자세한 내용은 게이트웨이의 작동원리를 참조 하세요.For more information about the gateway, see How the gateway works.

게이트웨이를 사용 하지 않고 Azure 가상 네트워크의 온-프레미스 리소스에 직접 액세스 하려면 통합 서비스 환경을 대신 만드는 것이 좋습니다.To directly access on-premises resources in Azure virtual networks without having to use the gateway, consider creating an integration service environment instead.

다른 서비스에서 게이트웨이를 사용하는 방법에 대한 내용은 다음 문서를 참조하세요.For information about how to use the gateway with other services, see these articles:

지원되는 데이터 원본Supported data sources

Azure Logic Apps 온-프레미스 데이터 게이트웨이는 이러한 데이터 원본에 대 한 온-프레미스 커넥터 를 지원 합니다.In Azure Logic Apps, the on-premises data gateway supports the on-premises connectors for these data sources:

  • BizTalk Server 2016BizTalk Server 2016
  • 파일 시스템File System
  • IBM DB2IBM DB2
  • IBM InformixIBM Informix
  • IBM MQIBM MQ
  • MySQLMySQL
  • Oracle 데이터베이스Oracle Database
  • PostgreSQLPostgreSQL
  • SAPSAP
  • SharePoint ServerSharePoint Server
  • SQL ServerSQL Server
  • TeradataTeradata

REST 또는 SOAP를 사용 하 여 HTTP 또는 HTTPS를 통해 데이터 원본에 연결 하는 사용자 지정 커넥터 를 만들 수도 있습니다.You can also create custom connectors that connect to data sources over HTTP or HTTPS by using REST or SOAP. 게이트웨이 자체는 추가 비용이 발생 하지 않지만 Logic Apps 가격 책정 모델 은 Azure Logic Apps의 이러한 커넥터 및 기타 작업에 적용 됩니다.Although the gateway itself doesn't incur additional costs, the Logic Apps pricing model applies to these connectors and other operations in Azure Logic Apps.

필수 구성 요소Prerequisites

  • 이미 로컬 컴퓨터에 온-프레미스 데이터 게이트웨이를 설치했습니다.You already installed the on-premises data gateway on a local computer. 이 게이트웨이 설치는이 설치에 연결 되는 게이트웨이 리소스를 만들기 전에 존재 해야 합니다.This gateway installation must exist before you can create a gateway resource that links to this installation.

  • 게이트웨이 설치에 사용한 것 과 동일한 Azure 계정 및 구독이 있습니다.You have the same Azure account and subscription that you used for your gateway installation. 이 Azure 계정은 단일 Azure Active Directory (AZURE AD) 테 넌 트 또는 디렉터리에만 속해야 합니다.This Azure account must belong only to a single Azure Active Directory (Azure AD) tenant or directory. 게이트웨이 관리자만 Azure에서 게이트웨이 리소스를 만들 수 있기 때문에 Azure에서 게이트웨이 리소스를 만들려면 동일한 Azure 계정 및 구독을 사용 해야 합니다.You need to use the same Azure account and subscription to create your gateway resource in Azure because only the gateway administrator can create the gateway resource in Azure. 서비스 사용자는 현재 지원 되지 않습니다.Service principals currently aren't supported.

    • Azure에서 게이트웨이 리소스를 만들 때 게이트웨이 설치를 선택 하 여 게이트웨이 리소스 및 해당 게이트웨이 리소스에만 연결 합니다.When you create a gateway resource in Azure, you select a gateway installation to link with your gateway resource and only that gateway resource. 각 게이트웨이 리소스는 하나의 게이트웨이 설치에만 연결할 수 있습니다.Each gateway resource can link to only one gateway installation. 다른 게이트웨이 리소스와 이미 연결 되어 있는 게이트웨이 설치는 선택할 수 없습니다.You can't select a gateway installation that's already associated with another gateway resource.

    • 논리 앱 및 게이트웨이 리소스는 동일한 Azure 구독에 존재 하지 않아도 됩니다.Your logic app and gateway resource don't have to exist in the same Azure subscription. 구독 액세스 권한이 있는 경우 온-프레미스 데이터 원본에 액세스할 수 있는 트리거 및 작업에서 게이트웨이 리소스가 있는 다른 Azure 구독을 선택할 수 있습니다.Provided that you have subscription access, in triggers and actions that can access on-premises data sources, you can select other Azure subscriptions that have gateway resources.

Azure 게이트웨이 리소스 만들기Create Azure gateway resource

로컬 컴퓨터에 게이트웨이를 설치한 후 게이트웨이에 대 한 Azure 리소스를 만듭니다.After you install the gateway on a local computer, create the Azure resource for your gateway.

  1. 게이트웨이를 설치 하는 데 사용 된 것과 동일한 Azure 계정으로 Azure Portal 에 로그인 합니다.Sign in to the Azure portal with the same Azure account that was used to install the gateway.

  2. Azure Portal 검색 상자에 "온-프레미스 데이터 게이트웨이"를 입력 하 고 온-프레미스 데이터게이트웨이를 선택 합니다.In the Azure portal search box, enter "on-premises data gateway", and select On-premises Data Gateways.

    "온-프레미스 데이터 게이트웨이" 찾기

  3. 온-프레미스 데이터 게이트웨이아래에서 추가를 선택 합니다.Under On-premises Data Gateways, select Add.

    데이터 게이트웨이에 대 한 새 Azure 리소스 추가

  4. 연결 게이트웨이 만들기에서 게이트웨이 리소스에 대해이 정보를 제공 합니다.Under Create connection gateway, provide this information for your gateway resource. 완료되면 만들기를 선택합니다.When you're done, select Create.

    속성Property DescriptionDescription
    리소스 이름Resource Name 문자, 숫자, 하이픈 ( - ), 밑줄 ( _ ), 괄호 ( ( , ) ) 또는 마침표 ()만 포함 하는 게이트웨이 리소스의 이름을 제공 . 합니다.Provide a name for your gateway resource that contains only letters, numbers, hyphens (-), underscores (_), parentheses ((, )), or periods (.).
    구독Subscription 게이트웨이 설치에 사용 된 Azure 계정에 대 한 Azure 구독을 선택 합니다.Select the Azure subscription for the Azure account that was used for the gateway installation. 기본 구독은 로그인하는 데 사용한 Azure 계정을 기반으로 합니다.The default subscription is based on the Azure account that you used to sign in.
    리소스 그룹Resource group 사용 하려는 Azure 리소스 그룹The Azure resource group that you want to use
    위치Location 게이트웨이를 설치하는 동안 게이트웨이 클라우드 서비스에 대해 선택한 것과 동일한 지역 또는 위치입니다.The same region or location that was selected for the gateway cloud service during gateway installation. 그렇지 않으면 게이트웨이 설치가 설치 이름 목록에 표시 되지 않습니다.Otherwise, your gateway installation won't appear in the Installation Name list. 논리 앱 위치는 게이트웨이 리소스 위치와 다를 수 있습니다.Your logic app location can differ from your gateway resource location.
    설치 이름Installation Name 이러한 조건이 충족 될 때만 목록에 표시 되는 게이트웨이 설치를 선택 합니다.Select a gateway installation, which appears in the list only when these conditions are met:

    -게이트웨이 설치는 만들려는 게이트웨이 리소스와 동일한 지역을 사용 합니다.- The gateway installation uses the same region as the gateway resource that you want to create.
    -게이트웨이 설치는 다른 Azure 게이트웨이 리소스에 연결 되지 않습니다.- The gateway installation isn't linked to another Azure gateway resource.
    -게이트웨이 설치는 게이트웨이 리소스를 만드는 데 사용 하는 것과 동일한 Azure 계정에 연결 됩니다.- The gateway installation is linked to the same Azure account that you're using to create the gateway resource.
    -Azure 계정은 단일 Azure Active Directory (AZURE AD) 테 넌 트 또는 디렉터리 에 속하며 게이트웨이 설치에 사용한 것과 동일한 계정입니다.- Your Azure account belongs to a single Azure Active Directory (Azure AD) tenant or directory and is the same account that you used for the gateway installation.

    자세한 내용은 질문과 대답 섹션을 참조 하세요.For more information, see the Frequently asked questions section.

    다음은 게이트웨이 리소스와 동일한 지역에 있고 동일한 Azure 계정에 연결 된 게이트웨이 설치를 보여 주는 예제입니다.Here is an example that shows a gateway installation that's in the same region as your gateway resource and is linked to the same Azure account:

    데이터 게이트웨이 리소스 만들기에 대 한 세부 정보 제공

온-프레미스 데이터 연결Connect to on-premises data

게이트웨이 리소스를 만들고 이 리소스에 Azure 구독을 연결한 후에는 해당 게이트웨이 사용하여 논리 앱과 온-프레미스 데이터 원본 간에 연결을 만들 수 있습니다.After you create your gateway resource and associate your Azure subscription with this resource, you can now create a connection between your logic app and your on-premises data source by using the gateway.

  1. Azure Portal의 논리 앱 디자이너에서 논리 앱을 만들거나 엽니다.In the Azure portal, create or open your logic app in the Logic App Designer.

  2. 온-프레미스 연결을 지원하는 SQL Server와 같은 커넥터를 추가합니다.Add a connector that supports on-premises connections, for example, SQL Server.

  3. 온-프레미스 데이터 게이트웨이를 통해 연결을 선택합니다.Select Connect via on-premises data gateway.

  4. 게이트웨이 구독 목록에서 원하는 게이트웨이 리소스가 있는 Azure 구독을 선택 합니다.Under Gateways, from the Subscriptions list, select your Azure subscription that has the gateway resource you want.

    구독 액세스 권한이 있는 경우 각각 다른 게이트웨이 리소스와 연결 된 다양 한 Azure 구독에서 선택할 수 있습니다.Provided that you have subscription access, you can select from different Azure subscriptions that are each associated with a different gateway resource. 논리 앱 및 게이트웨이 리소스는 동일한 Azure 구독에 존재 하지 않아도 됩니다.Your logic app and gateway resource don't have to exist in the same Azure subscription.

  5. 선택한 구독에서 사용 가능한 게이트웨이 리소스를 보여 주는 연결 게이트웨이 목록에서 원하는 게이트웨이 리소스를 선택 합니다.From the Connection Gateway list, which shows the available gateway resources in your selected subscription, select the gateway resource that you want. 각 게이트웨이 리소스는 단일 게이트웨이 설치에 연결 됩니다.Each gateway resource is linked to a single gateway installation.

    참고

    논리 앱의 위치는 게이트웨이 리소스의 위치와 다를 수 있기 때문에 게이트웨이 목록에는 다른 지역의 게이트웨이 리소스가 포함 되어 있습니다.The gateways list includes gateway resources in other regions because your logic app's location can differ from your gateway resource's location.

  6. 만들려는 연결에 따라 고유한 연결 이름 및 기타 필요한 정보를 제공 합니다.Provide a unique connection name and other required information, which depends on the connection that you want to create.

    고유한 연결 이름을 사용 하면 나중에 여러 연결을 만드는 경우 해당 연결을 쉽게 찾을 수 있습니다.A unique connection name helps you easily find that connection later, especially if you create multiple connections. 해당하는 경우 사용자 이름의 정규화된 도메인도 포함됩니다.If applicable, also include the qualified domain for your username.

    예를 들면 다음과 같습니다.Here is an example:

    논리 앱과 데이터 게이트웨이 간에 연결 만들기

  7. 완료되면 만들기를 선택합니다.When you're done, select Create.

게이트웨이 연결에 논리 앱을 사용할 준비가 되었습니다.Your gateway connection is now ready for your logic app to use.

연결 편집Edit connection

게이트웨이 연결에 대 한 설정을 업데이트 하려면 연결을 편집할 수 있습니다.To update the settings for a gateway connection, you can edit your connection.

  1. 논리 앱에 대 한 모든 API 연결을 찾으려면 논리 앱의 메뉴에 있는 개발 도구아래에서 api 연결을 선택 합니다.To find all the API connections for just your logic app, on your logic app's menu, under Development Tools, select API connections.

    논리 앱 메뉴에서 "API 연결"을 선택 합니다.

  2. 원하는 게이트웨이 연결을 선택 하 고 API 연결 편집을 선택 합니다.Select the gateway connection you want, and then select Edit API connection.

    업데이트가 적용 되지 않는 경우 게이트웨이 설치를 위해 게이트웨이 Windows 서비스 계정을 중지 하 고 다시 시작 해 보세요.If your updates don't take effect, try stopping and restarting the gateway Windows service account for your gateway installation.

Azure 구독에 연결된 모든 API 연결을 찾으려면:To find all API connections associated with your Azure subscription:

  • Azure Portal 메뉴에서 모든 서비스 > > API 연결을 선택 합니다.From the Azure portal menu, select All services > Web > API Connections.
  • 또는 Azure Portal 메뉴에서 모든 리소스를 선택 합니다.Or, from the Azure portal menu, select All resources. 유형 필터를 API 연결로 설정 합니다.Set the Type filter to API Connection.

게이트웨이 리소스 삭제Delete gateway resource

다른 게이트웨이 리소스를 만들거나, 게이트웨이 설치를 다른 게이트웨이 리소스에 연결 하거나, 게이트웨이 리소스를 제거 하려면 게이트웨이 설치에 영향을 주지 않고 게이트웨이 리소스를 삭제할 수 있습니다.To create a different gateway resource, link your gateway installation to a different gateway resource, or remove the gateway resource, you can delete the gateway resource without affecting the gateway installation.

  1. Azure Portal 메뉴에서 모든 리소스를 선택 하거나 모든 페이지에서 모든 리소스 를 검색 하 고 선택 합니다.From the Azure portal menu, select All resources, or search for and select All resources from any page. 게이트웨이 리소스를 찾아 선택합니다.Find and select your gateway resource.

  2. 게이트웨이 리소스 메뉴에서 아직 선택하지 않은 경우 온-프레미스 데이터 게이트웨이를 선택합니다.If not already selected, on your gateway resource menu, select On-premises Data Gateway. 게이트웨이 리소스 도구 모음에서 삭제를 선택 합니다.On the gateway resource toolbar, select Delete.

    예를 들면 다음과 같습니다.For example:

    Azure에서 게이트웨이 리소스 삭제

질문과 대답Frequently asked questions

Q: Azure에서 게이트웨이 리소스를 만들 때 게이트웨이 설치가 나타나지 않는 이유는 무엇 인가요?Q: Why doesn't my gateway installation appear when I create my gateway resource in Azure?
A: 이 문제는 다음과 같은 이유 때문에 발생할 수 있습니다.A: This issue can happen for these reasons:

  • Azure 계정은 로컬 컴퓨터의 게이트웨이 설치에 사용한 것과 동일한 계정이 아닙니다.Your Azure account isn't the same account that you used for the gateway installation on your local computer. 게이트웨이 설치에 사용한 것과 동일한 id를 사용 하 여 Azure Portal에 로그인 했는지 확인 합니다.Check that you signed in to the Azure portal with the same identity that you used for the gateway installation. 게이트웨이 관리자만 Azure에서 게이트웨이 리소스를 만들 수 있습니다.Only the gateway administrator can create the gateway resource in Azure. 서비스 사용자는 현재 지원 되지 않습니다.Service principals currently aren't supported.

  • Azure 계정은 단일 AZURE AD 테 넌 트 또는 디렉터리에만 속해 있지 않습니다.Your Azure account doesn't belong to only a single Azure AD tenant or directory. 게이트웨이 설치 중에 사용한 것과 동일한 Azure AD 테 넌 트 또는 디렉터리를 사용 하 고 있는지 확인 합니다.Check that you're using the same Azure AD tenant or directory that you used during gateway installation.

  • 게이트웨이 리소스와 게이트웨이 설치는 동일한 지역에 존재 하지 않습니다.Your gateway resource and gateway installation don't exist in the same region. 그러나 논리 앱의 위치는 게이트웨이 리소스 위치와 다를 수 있습니다.However, your logic app's location can differ from your gateway resource location.

  • 게이트웨이 설치는 이미 다른 게이트웨이 리소스와 연결 되어 있습니다.Your gateway installation is already associated with another gateway resource. 각 게이트웨이 리소스는 하나의 게이트웨이 설치에만 연결할 수 있으며 Azure 계정 및 구독 하나에만 연결할 수 있습니다.Each gateway resource can link to only one gateway installation, which can link to only one Azure account and subscription. 따라서 다른 게이트웨이 리소스와 이미 연결 되어 있는 게이트웨이 설치를 선택할 수 없습니다.So, you can't select a gateway installation that's already associated with another gateway resource. 이러한 설치는 설치 이름 목록에 표시 되지 않습니다.These installations won't appear in the Installation Name list.

    Azure Portal에서 게이트웨이 등록을 검토 하려면 모든 azure 구독에서 온-프레미스 데이터 게이트웨이 리소스 종류를 포함 하는 모든 azure 리소스를 찾습니다.To review your gateway registrations in the Azure portal, find all your Azure resources that have the On-premises Data Gateways resource type across all your Azure subscriptions. 다른 게이트웨이 리소스에서 게이트웨이 설치의 연결을 끊으려면 게이트웨이 리소스 삭제를 참조 하세요.To unlink the gateway installation from the other gateway resource, see Delete gateway resource.

Q:: 내 기존 게이트웨이에 대한 위치가 변경된 이유가 무엇입니까?Q: Why did the location for my existing gateway change?
A: 2017년 5월 3일 이전에 만든 게이트웨이 리소스는 해당 게이트웨이를 만든 회사 또는 학교 계정에 대한 Azure AD 테넌트의 원래 위치로 이동되었습니다.A: Gateway resources created before May 3, 2017 were moved to the original locations of the Azure AD tenant for the work or school account that created those gateways. 그러나 이러한 변경 내용은 평소대로 작업을 계속해야 하는, 현재 실행 중인 논리 앱에 영향을 주어서는 안됩니다.However, these changes shouldn't affect currently running logic apps, which should continue working as usual. 5월의 게이트웨이의 일반적 가용성과 함께 게이트웨이 리소스 위치는 논리 앱 위치에 따라 다를 수 있습니다.With the gateway's general availability in May, gateway resource locations can differ from logic app locations.

다음 단계Next steps