Python 코드 조각 사용

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

코드 조각 생성

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

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

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

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

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

코드 조각 추가

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

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

   코드 조각 라이브러리 항목 선택 드롭다운 목록에는 조각을 추가할 수 있는 라이브러리가 표시됩니다. 해당 목록은 공유가 상속으로 설정된 라이브러리의 조각 수를 나타내기도 합니다.

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

   비고:

   런타임 7.0 이전 버전을 사용하는 Notebook의 경우 들여쓰기 또는 기타 구문 오류를 방지하기 위해 코드를 직접 입력하는 대신 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을 가져옵니다.
   • 포털 로그를 쿼리하고 CSV로 저장합니다(ArcGIS Enterprise만 해당).
   • ArcPy 포털에 로그인합니다.
2. 콘텐츠 관리 - GIS의 콘텐츠 및 Notebook 작업 영역 디렉터리의 파일을 관리하는 데 도움이 되는 코드 조각
   • 작업 영역 디렉터리에 지오데이터베이스를 복사합니다.
   • 비어 있는 피처 클래스로 파일 지오데이터베이스를 생성합니다.
   • 작업 영역 디렉터리에 폴더를 생성합니다.
   • 포털에서 작업 영역 디렉터리에 파일 항목을 다운로드합니다.
   • 데이터셋을 나열합니다.
   • 파일을 나열합니다.
   • 작업 영역 디렉터리에서 파일 지오데이터베이스를 제거합니다.
   • 작업 영역 디렉터리에서 폴더를 제거합니다.
   • 작업 영역 디렉터리에 파일의 압축을 풉니다.
3. 데이터 사이언스 및 분석 - ArcGIS API for Python, ArcPy, 기타 Python 라이브러리를 사용하여 데이터 사이언스 및 분석 워크플로에서 구현할 수 있는 코드 조각

   비고:

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

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