Python 코드 조각 사용

ArcGIS Enterprise 11.0부터 ArcGIS Notebook Server는 코드 조각이라는 재사용 가능한 코드의 미리 작성된 부분을 찾아 Notebook에 삽입할 수 있습니다.

코드 조각 생성

Notebook에서 코드 조각을 생성할 수 있습니다. 생성한 조각은 동일한 Notebook 또는 다른 Notebook에서 사용할 수 있습니다. 생성한 코드 조각은 Notebook 코드 조각 라이브러리 항목에 저장되어 조각을 구성하는 데 사용되며 공유할 수 있습니다.

코드 조각을 생성하려면 먼저 조각을 저장할 Notebook 코드 조각 라이브러리를 생성해야 합니다. 코드 조각 라이브러리에는 최대 100개의 조각이 포함될 수 있습니다.

Notebook 코드 조각 라이브러리 생성

코드 조각 라이브러리를 생성하려면 다음 단계를 완료합니다.

1. Notebook 편집기의 리본 상단에서 코드 조각을 클릭합니다.
2. 추가 버튼 을 클릭하고 라이브러리 항목 생성을 선택합니다.
3. 라이브러리의 제목 및 요약을 입력하고 필요에 따라 라이브러리에 저장된 코드 조각을 나타내는 태그를 추가합니다.
4. 필요한 경우 내 콘텐츠에서 코드 조각 라이브러리를 저장할 폴더를 선택할 수 있습니다.
5. 생성을 클릭합니다.

코드 조각 라이브러리를 생성하면 다른 항목과 마찬가지로 기관에 저장됩니다. 코드 조각 창에서 추가 옵션 버튼 을 클릭하고 라이브러리 항목 관리를 클릭하여 코드 조각 라이브러리를 관리할 수 있습니다. 코드 조각 라이브러리 항목 관리 창에서 새 코드 조각 라이브러리를 생성할 수 있으며, 각 코드 조각 라이브러리에 대해 항목 세부정보 페이지를 공유, 편집, 확인하고 라이브러리를 더 이상 사용되지 않는 항목으로 표시할 수 있습니다.

코드 조각 추가

라이브러리를 생성했다면 코드 조각을 추가할 수 있습니다. 코드 조각을 추가하려면 다음을 수행합니다.

1. Notebook 편집기의 리본 상단에서 코드 조각을 클릭합니다.
2. 추가 버튼 을 클릭하고 코드 조각 추가를 선택합니다.
3. 코드 조각의 제목을 입력하고 추가할 라이브러리를 선택한 다음 설명을 입력합니다.

   코드 조각 라이브러리 항목 선택 드롭다운 목록에는 조각을 추가할 수 있는 라이브러리가 표시됩니다. 해당 목록은 해당 라이브러리에 있는 조각 수 또한 나타냅니다.

4. 조각에 대한 코드를 추가하려면 다음 중 하나를 수행합니다.
   • Notebook이 런타임 8.0 이후 버전을 사용하는 경우 코드 조각으로 추가할 셀을 선택하고 활성 셀에서 복사를 클릭합니다.
   • Notebook이 런타임 7.0 이전 버전을 사용하는 경우 코드 조각에 대한 코드를 입력합니다.

     비고:

     들여쓰기 또는 기타 구문 오류를 방지하기 위해 코드를 직접 입력하는 대신 Notebook 셀에서 코드를 복사하여 붙여넣습니다.

5. 저장을 클릭합니다.

조각에 대한 추가 옵션 버튼 을 클릭하여 코드 조각을 변경할 수 있습니다. 추가 옵션 드롭다운 메뉴에서는 코드 조각을 편집, 사용 중단, 삭제하는 옵션을 제공합니다.

코드 조각 삽입

코드 조각 창을 통해 다음 단계를 완료하여 코드 조각을 삽입합니다.

1. Notebook 편집기의 리본 상단에서 코드 조각을 클릭합니다.
2. 삽입할 조각이 포함된 코드 조각 라이브러리를 찾습니다.
3. 코드 미리 보기를 확인하려면 조각에 대한 세부정보 보기를 클릭합니다.
4. 삽입할 코드 조각을 찾았으면 코드 조각 창에서 추가 버튼 을 클릭하거나 코드 미리 보기 창에서 Notebook에 삽입을 클릭하여 코드 조각을 Notebook에 새 셀로 삽입합니다.

다음은 Notebook에 추가되는 코드 조각의 예시입니다.

# curated code snippet inserted from the Code snippets pane
from arcgis.gis import GIS
def check_org_credits_agol(gis: GIS):
    if "admin" in gis.__dict__:
        credits = gis.admin.credits.credits
        print(f"This ArcGIS Online organization has {credits} credits.")
    else:
        print("Please connect to the ArcGIS Online organization as an administrator to check credits.")

# create a GIS instance to pass to the code snippet function
gis_agol = GIS("https://www.arcgis.com/", "<admin_username>")

# call the code snippet function with your GIS instance
check_org_credits_agol(gis_agol)

Esri 코드 조각

사용 가능한 모든 코드 조각은 Esri에서 선별됩니다. 이러한 선별된 코드 조각을 사용하면 Notebooks에서 공통 GIS 워크플로를 구현할 수 있습니다. 코드 조각은 Python 함수로 작성되었으며 Notebook에 삽입할 수 있고 Notebook 전체에서 호출할 수 있습니다. 코드 조각을 Notebook에 추가한 후에는 편집할 수도 있습니다.

비고:

11.0에서 선별된 코드 조각의 이름과 설명은 영어로만 제공됩니다.

다음은 Notebook에 삽입할 수 있는 사용 가능한 코드 조각입니다.

1. GIS 관리 — 공통 GIS 관리 작업을 수행하는 코드 조각

   비고:

   이러한 코드 조각 중 대부분은 관리자 연결이 필요합니다.

   • 남은 크레딧 확인(ArcGIS Online만 해당)
   • 특정 사용자의 크레딧 확인(ArcGIS Online만 해당)
   • 레이어 항목의 기본 서비스 URL 가져오기
   • 실패한 Notebook 작업 쿼리
   • 포털 로그를 쿼리하고 CSV로 저장합니다(ArcGIS Enterprise만 해당).
   • ArcPy 포털에 로그인
2. 콘텐츠 관리 — GIS의 콘텐츠 및 Notebook 작업 영역 디렉터리의 파일을 관리하는 데 도움이 되는 코드 조각
   • 작업 영역 디렉터리에 지오데이터베이스 복사
   • 비어 있는 피처 클래스로 파일 지오데이터베이스 생성
   • 작업 영역 디렉터리에 폴더 생성
   • 포털에서 작업 영역 디렉터리로 파일 항목 다운로드
   • 데이터셋 나열
   • 파일 나열
   • 작업 영역 디렉터리에서 파일 지오데이터베이스 제거
   • 작업 영역 디렉터리에서 폴더 제거
   • 작업 영역 디렉터리에 파일 압축 해제
3. 데이터 사이언스 및 분석 — ArcGIS API for Python, ArcPy, 기타 Python 라이브러리를 사용하여 데이터 사이언스 및 분석 워크플로에서 구현할 수 있는 코드 조각

   비고:

   Advanced Notebook 런타임을 사용하여 ArcPy가 필요한 코드 조각을 실행합니다. Notebook 런타임에 대한 자세한 내용은 Notebook 런타임 지정을 참고하세요.

   • 피처 클래스를 피처 레이어로 변환
   • 피처 클래스를 공간적으로 활성화된 데이터 프레임으로 변환
   • 피처 레이어를 공간적으로 활성화된 데이터 프레임으로 변환
   • 공간적으로 활성화된 데이터 프레임을 피처 클래스로 변환
   • URL의 이미지 표시
   • 작업 영역 디렉터리의 이미지 표시
   • 누락 값 채우기
   • 피처 클래스의 필드 나열
   • 레이어의 필드 나열
   • 항목의 레이어 나열
   • 공간적으로 활성화된 데이터 프레임 플롯(빠른 시작)
   • 클래스 구분점 렌더러를 사용하여 공간적으로 활성화된 데이터 프레임 플롯
   • 단순 렌더러를 사용하여 공간적으로 활성화된 데이터 프레임 플롯
   • 고유 값 렌더러를 사용하여 공간적으로 활성화된 데이터 프레임 플롯
   • 공간적으로 활성화된 데이터 프레임을 피처 레이어로 발행